summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorlouie <lshprung@yahoo.com>2021-12-10 15:26:13 -0800
committerlouie <lshprung@yahoo.com>2021-12-10 15:26:13 -0800
commita3d8a9508f3d0edfffc1ab5791bb29b0ae7a79c5 (patch)
treef546c0bf53e07fec255529c82c42148b1c9f0ae1 /docs
parente58f35f4580ad4377c3ba5dcaee5bbbd938713c6 (diff)
Changed name. May tidy up/differentiate 'Terminal Media Launcher' vs 'terminal-media-launcher'
Diffstat (limited to 'docs')
-rw-r--r--docs/README.md34
-rw-r--r--docs/terminal-media-launcher-config.5.gzbin0 -> 2383 bytes
-rw-r--r--docs/terminal-media-launcher-config.md (renamed from docs/tml-config.md)10
-rw-r--r--docs/terminal-media-launcher.1.gzbin0 -> 1022 bytes
-rw-r--r--docs/tml-config.5.gzbin2330 -> 0 bytes
-rw-r--r--docs/tml.1.gzbin971 -> 0 bytes
-rw-r--r--docs/windows_compile_instructions.md6
7 files changed, 25 insertions, 25 deletions
diff --git a/docs/README.md b/docs/README.md
index 97b414a..08a5784 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,28 +1,28 @@
## Introduction
-**Terminal Media Launcher** is a command line utility to help streamline launching applications and other media. The goal of tml 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.
+**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)
-tml can be compiled on any system with make, gcc, and the ncurses library (libncurses-dev) installed. It can be compiled and installed on any Linux distribution, and can also be compiled and run on Windows 10. To compile and run tml:
+terminal-media-launcher can be compiled on any system with make, gcc, and the ncurses library (libncurses-dev) installed. It can be compiled and installed on any Linux distribution, and can also be compiled and run on Windows 10. To compile and run terminal-media-launcher:
1. Clone the repository
-2. Run `make` in the directory the repository was cloned into. This will create a file called `tml`
-3. `./tml` to run the program
+2. Run `make` in the directory the repository was cloned into. This will create a file called `terminal-media-launcher`
+3. `./terminal-media-launcher` to run the program
-Note that tml will not run until you have created a configuration file.
+Note that terminal-media-launcher will not run until you have created a configuration file.
### Installation
-tml can be installed on Linux by running:
+terminal-media-launcher can be installed on Linux by running:
```
sudo make install
```
-This will install `tml` to `/usr/local/bin/tml` as well as man pages `tml` and `tml-config`.
+This will install `terminal-media-launcher` to `/usr/local/bin/terminal-media-launcher` as well as man pages `terminal-media-launcher` and `terminal-media-launcher-config`.
To uninstall these files:
```
@@ -31,13 +31,13 @@ sudo make uninstall
### Create Desktop Entry
-If tml is installed (see above), a Desktop Entry can be created on Linux by running:
+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/tml.desktop`.
+This will create a desktop entry at `/usr/local/share/applications/terminal-media-launcher.desktop`.
## Screenshots
@@ -46,23 +46,23 @@ This will create a desktop entry at `/usr/local/share/applications/tml.desktop`.
## Configuration File
-By default, tml searches in the following order for a configuration file:
+By default, terminal-media-launcher searches in the following order for a configuration file:
### Linux
-1. `$HOME/.config/tml/config`
-2. `$HOME/.tml/config`
+1. `$HOME/.config/terminal-media-launcher/config`
+2. `$HOME/.terminal-media-launcher/config`
### Windows
-1. `%APPDATA%\tml\config`
+1. `%APPDATA%\terminal-media-launcher\config`
A different configuration file location can also be specified with the `-c` flag:
```
-tml -c /path/to/config
+terminal-media-launcher -c /path/to/config
```
-For Documentation of the configuration file, see [tml-config](tml-config.md).
-For a help message and list of flags, `tml --help`.
-If you installed tml, you can also consult **tml**(1) and **tml-config**(5).
+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`.
+If you installed terminal-media-launcher, you can also consult **terminal-media-launcher**(1) and **terminal-media-launcher-config**(5).
diff --git a/docs/terminal-media-launcher-config.5.gz b/docs/terminal-media-launcher-config.5.gz
new file mode 100644
index 0000000..23250a5
--- /dev/null
+++ b/docs/terminal-media-launcher-config.5.gz
Binary files differ
diff --git a/docs/tml-config.md b/docs/terminal-media-launcher-config.md
index 41398c1..3d12f97 100644
--- a/docs/tml-config.md
+++ b/docs/terminal-media-launcher-config.md
@@ -1,6 +1,6 @@
## Introduction
-**config** specifies settings for Terminal Media Launcher, including preferences, groups, entries, and file locations. Each line of `config` is read by tml unless the line is empty or the line begins with a '#'. tml can automatically generate a configuration file if no such file is found. An automatically generated configuration file will create groups for Music, Pictures, and Videos, and add entries to each group from the respective directory in the user's home directory. It is highly recommended that the user edit the configuration file manually.
+**config** specifies settings for Terminal Media Launcher, including preferences, groups, entries, and file locations. Each line of `config` is read by terminal-media-launcher unless the line is empty or the line begins with a '#'. terminal-media-launcher can automatically generate a configuration file if no such file is found. An automatically generated configuration file will create groups for Music, Pictures, and Videos, and add entries to each group from the respective directory in the user's home directory. It is highly recommended that the user edit the configuration file manually.
## Table of Contents
@@ -25,7 +25,7 @@
## Creating a Group <a name="CreatingAGroup"></a>
-tml will not work without any groups, so you will need to know how to create a group.
+terminal-media-launcher will not work without any groups, so you will need to know how to create a group.
### addGroup
@@ -37,7 +37,7 @@ tml will not work without any groups, so you will need to know how to create a g
- **setLauncher** *group* */path/to/launcher*
-`setLauncher` will set a group's launching application. If no launching application is specified for a group, tml will treat each entry in that group as an executable file. If there is a space in the path to the launching application, it must be written in quotes (ex. "/usr/bin/my launcher"). *Keep in mind that the path to the launching application should be absolute*.
+`setLauncher` will set a group's launching application. If no launching application is specified for a group, terminal-media-launcher will treat each entry in that group as an executable file. If there is a space in the path to the launching application, it must be written in quotes (ex. "/usr/bin/my launcher"). *Keep in mind that the path to the launching application should be absolute*.
### setLauncherRaw
@@ -53,7 +53,7 @@ tml will not work without any groups, so you will need to know how to create a g
## Adding Entries <a name=AddingEntries></a>
-tml will hide empty groups, so you will need to know how to add entries to a group.
+terminal-media-launcher will hide empty groups, so you will need to know how to add entries to a group.
### add
@@ -118,7 +118,7 @@ If any of the following settings are specified, they should be at the top of the
- **foldCase** *on/off*
-Entering any non-traversal input in tml can be used to jump to a group or entry. For instance, hitting 'f' on the keyboard will jump the cursor to the next group or entry that starts with an 'f'. *foldCase* determines whether or not this functionality is **case insensitive (on)** or **case sensitive (off)**. *foldCase* is turned on by default.
+Entering any non-traversal input in terminal-media-launcher can be used to jump to a group or entry. For instance, hitting 'f' on the keyboard will jump the cursor to the next group or entry that starts with an 'f'. *foldCase* determines whether or not this functionality is **case insensitive (on)** or **case sensitive (off)**. *foldCase* is turned on by default.
### sort
diff --git a/docs/terminal-media-launcher.1.gz b/docs/terminal-media-launcher.1.gz
new file mode 100644
index 0000000..de27be3
--- /dev/null
+++ b/docs/terminal-media-launcher.1.gz
Binary files differ
diff --git a/docs/tml-config.5.gz b/docs/tml-config.5.gz
deleted file mode 100644
index fde914d..0000000
--- a/docs/tml-config.5.gz
+++ /dev/null
Binary files differ
diff --git a/docs/tml.1.gz b/docs/tml.1.gz
deleted file mode 100644
index 33c4e83..0000000
--- a/docs/tml.1.gz
+++ /dev/null
Binary files differ
diff --git a/docs/windows_compile_instructions.md b/docs/windows_compile_instructions.md
index 8966263..21530fb 100644
--- a/docs/windows_compile_instructions.md
+++ b/docs/windows_compile_instructions.md
@@ -10,13 +10,13 @@ Compiling on Windows requires access to the MinGW toolchain. The easiest way to
4. `pacman -S git mingw-w64-x86_64-gcc mingw-w64-x86_64-ncurses make` to install necessary packages
-5. `git clone https://github.com/lshprung/tml` to clone the repository
+5. `git clone https://github.com/lshprung/terminal-media-launcher` to clone the repository
-6. `cd tml` to enter the repository
+6. `cd terminal-media-launcher` to enter the repository
7. `make` to compile
-If you did everything correctly, compilation should succeed. Open File Explorer in the current directory (can be done by running `explorer .` in MSYS2 terminal) and double click the generated executable (should be called tml.exe)
+If you did everything correctly, compilation should succeed. Open File Explorer in the current directory (can be done by running `explorer .` in MSYS2 terminal) and double click the generated executable (should be called terminal-media-launcher.exe)
## Resolving Missing .dll Files