A TUI to monitor YouTube channels
Go to file
Daniel Schulte 539e51ab0f Remove references to prerelease termpaint distribution and use pkg-config 2020-11-28 10:49:40 +01:00
.gitignore Initial commit 2020-11-22 16:17:14 +01:00
README.md Update README wording regarding dependencies 2020-11-27 00:33:23 +01:00
db.cpp Move more database stuff out of the main application file 2020-11-22 21:29:45 +01:00
db.h Move more database stuff out of the main application file 2020-11-22 21:29:45 +01:00
main.cpp Don't explicitly store the video count in the channel object anymore 2020-11-26 19:44:37 +01:00
subprocess.h Add watchCommand config option 2020-11-26 19:30:26 +01:00
tui.cpp Implement a better text wrapping algorithm 2020-11-27 00:32:10 +01:00
tui.h Implement a better text wrapping algorithm 2020-11-27 00:32:10 +01:00
yt-tool-tui.pro Remove references to prerelease termpaint distribution and use pkg-config 2020-11-28 10:49:40 +01:00
yt.cpp Don't explicitly store the video count in the channel object anymore 2020-11-26 19:44:37 +01:00
yt.h Don't explicitly store the video count in the channel object anymore 2020-11-26 19:44:37 +01:00
yttui.conf.example Change default database location and name 2020-11-26 19:38:00 +01:00

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)
  • A modern, C++17 capable compiler
  • qmake
  • make
  • pkg-config
  • Installed (it may also be required to install separate development packages) and accesible via pkg-config:

How to build

  1. Create a build folder and open a terminal there.
  2. Run qmake. E.g. qmake ...
  3. Run make.
  4. You can now start the application by running ./yttui (but have a look at the configuration options first).

Getting started

  1. Build 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}}"]