Colette is a todo list manager that runs in the command line. It aims to be quick and simple to use while providing enough features to satisfy the needs of every command line lover.

Here's a list of Colette's main features:

• Pure Python - Colette is written in pure Python with no dependencies other than Python itself.
• Simple but powerful list management - Add, remove and edit entries, mark them as completed, sort your todo list etc.
• Easy storage - Colette stores the todo list into a human-readable file that can be modified with a text editor if desired.
• Configurability - Colette is configurable with a TOML file.

1. Download colette-*.zip from the Releases section of the GitHub repository.

2. Unzip the entire contents of colette-*.zip to a folder of your choice.

3. Add the following line to your shell configuration file:

   PATH=$PATH:/path/to/extracted/binary

Once you have performed the steps above, you can launch Colette by simply typing colette into the terminal.

Refer to the instructions in the Building Colette section.

Launch Colette and type help for a list of commands supported by Colette.

For building from source, Colette has the following dependencies:

• Python 3.11 or newer version (3.11.2 is the lowest tested version. Latest version recommended.)
• pip or pipx
• PyInstaller
• mkdocs

Install all of the dependencies as instructed for your operating system before building Colette. You can run the following command to install PyInstaller and mkdocs:

pip(x) install -r requirements.txt

An automated build script named build.sh is supplied with Colette's source code. This is the recommended way to build Colette and its documentation from source.

You may need to make the build script executable before being able to run it. If the script fails to execute, it is likely that you do not have execution permissions for it yet. In that case, make it executable with the following command:

chmod  x build.sh

After making the script executable, run it like so:

./build.sh

After building Colette, you can run it by navigating into one of the directories generated by PyInstaller (either build/colette/ or dist/colette/) and typing the following command:

./colette

You can also run Colette without building it by running the main.py file from the src/ directory.

NOTE: The table below contains only the terminals Colette has been tested in. If you don't see your terminal in the table, Colette has likely not been tested in it. Compatibility is not guaranteed in this case.

Colette is licensed under MIT. See the LICENSE file for details.

This project uses code from the following resources:

• console-color Gist by kamito