yttui/README.md

yttui

This is a TUI tool to monitor YouTube channels for new videos and keep track of which ones you've watched already. This tool is work in progress and some functions might not work (correctly).

Building

Requirements:

• Linux (other platforms are untested and likely require additional work)
• A modern, C++17 capable compiler
• meson
• ninja
• pkg-config
• Installed (it may also be required to install separate development packages) and accesible via pkg-config:
  • libcurl
  • nlohmann-json (at least version 3.5.0)
  • sqlite3
  • termpaint

How to build

1. Create a build folder.
2. Configure the project by running e.g. meson setup /path/to/build/dir in the source directory. See meson setup --help for available configuration options.
3. Build the application with meson compile -C /path/to/build/dir.
4. You can now start the application by running /path/to/build/dir/yttui (but have a look at the configuration options first).
5. Optionally you can install the application by running meson install -C /path/to/build/dir.

Getting started

1. Build (and optionally install) the application
2. Get a YouTube API key.
3. Create a configuration file.
   • You can either put it next to the application binary or in $HOME/.config/yttui.conf
   • Have a look at yttui.conf.example. It contains all possible configuration options and is a good place to start.
   • Configuration default values are described in "Configuration options".
4. Start the application. You can press F1 at any time to get help and C-q (holding down the control key and pressing q) to quit.

Configuration options

Option	Description	Default value	Required
apiKey	YouTube API Key		✓
extraHeaders	Extra HTTP headers to send to YouTube. This is a JSON array of objects containing "key" and "value". Will be sent with each API requres.	[]	✘
database	Path of channel/video database	$HOME/.local/share/yttui.db	✘
watchCommand	Command executed to watch a video. {{vid}} will be replaced by the Id of the video to watch.	["xdg-open", "https://youtube.com/watch?v={{vid}}"]	✘