1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
## Introduction
**Terminal Media Launcher** is a command line utility to help streamline launching applications and other media. The goal of this program is to provide a fast, minimal, command line frontend with a Unix-like approach to setup and configuration. The program looks for a configuration file listing different groups of media and creates an ncurses menu from which to select from. If a configuration file is found, the program will draw two columns: one for groups, and one for entries. At the bottom of the window, a preview of the command execution is displayed.
## Compiling and Running
For Windows instructions, see [here](windows_compile_instructions.md)
terminal-media-launcher can be compiled on any system with make, gcc, and the ncurses development library installed. It can be compiled and installed on any Linux distribution, and can also be compiled and run on Microsoft Windows. To compile and run terminal-media-launcher:
1. Install dependencies.
On Debian and Debian-based systems:
```
# apt install gcc libncurses-dev make
```
2. Download the latest `.tar.gz` release
- The source acquired from the source repository can also be compiled, but requires additional dependencies to build (`autoconf`, `automake`, `autoconf-archive`)
3. Run the commands below in the directory the repository was cloned into. This will build the binary `src/terminal-media-launcher`
```
$ ./configure
$ make
```
4. To run the program:
```
$ src/terminal-media-launcher
```
Note that terminal-media-launcher will not run until you have created a configuration file.
### Installation
terminal-media-launcher can be installed by running:
```
make install
```
To uninstall these files:
```
make uninstall
```
By default, the program and related files are installed with prefix `/usr/local`, but this prefix can be changed with `./configure --prefix=PREFIX` flag (i.e., `./configure --prefix=$HOME/.local`
<!--
### Create Desktop Entry
If terminal-media-launcher is installed (see above), a Desktop Entry can be created on Linux by running:
```
sudo make desktop-entry
```
This will create a desktop entry at `/usr/local/share/applications/terminal-media-launcher.desktop`.
-->
## Screenshots
## Configuration File
By default, terminal-media-launcher searches in the following order for a configuration file:
### Linux
1. `$HOME/.config/terminal-media-launcher/config`
2. `$HOME/.terminal-media-launcher/config`
### Windows
1. `%APPDATA%\terminal-media-launcher\config`
A different configuration file location can also be specified with the `-c` flag:
```
terminal-media-launcher -c /path/to/config
```
For Documentation of the configuration file, see [terminal-media-launcher-config](terminal-media-launcher-config.md).
For a help message and list of flags, `terminal-media-launcher --help`.
You can also consult the man pages **terminal-media-launcher**(1) and **terminal-media-launcher-config**(5)
|
