59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# subs [](https://travis-ci.com/mitchweaver/subs)
|
|
|
|
Have a feed of your YouTube subscriptions.
|
|
|
|
Select a choice and with dmenu and view with mpv.
|
|
|
|
## About
|
|
|
|
I'm a fan of command line and "doing things yourself". I also don't
|
|
like having a Google account, but still want to keep track of
|
|
subscriptions. Thus [subs](http://github.com/mitchweaver/subs) was born.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Environment
|
|
|
|
Create your `$SUBS_FILE`, as described below, and export this var its path.
|
|
|
|
Next set your `$SUBS_MENU_PROG` if desired, by default the menu will be `dmenu -p Subs:`.
|
|
|
|
## Usage
|
|
|
|
First generate the links to the XML feeds of your subscriptions via `subs -g`.
|
|
|
|
Once this has completed, this needn't be done again unless you update your `$SUBS_FILE`.
|
|
|
|
Next, update your subs cache via `subs -u`. This will fetch any
|
|
changes from the feeds and store it back into the cache locally.
|
|
This way the cache only is updated when you choose to, rather than
|
|
redownloading them all every run.
|
|
|
|
## Subs File
|
|
|
|
The `$SUBS_FILE` file is a normal text file containing usernames of your subscriptions.
|
|
These can be the username or the channel IDs.
|
|
|
|
Comments and blank lines are ignored.
|
|
Here is a short example:
|
|
|
|
```
|
|
# Travel
|
|
UCXulruMI7BHj3kGyosNa0jA # Indigo Traveller
|
|
cmbroad44 # Abroad in Japan
|
|
# Misc
|
|
UCimiUgDLbi6P17BdaCZpVbg # exurb1a
|
|
Vsauce # Vsauce
|
|
UCF9cNYdVSYS_oha1eGzDTGQ # Goniloc
|
|
```
|
|
|
|
As you can see, some of these are usernames and some are channel IDs -- either work just fine.
|
|
|
|
## Safety
|
|
|
|
Every commit is [shellchecked](https://github.com/mitchweaver/subs/blob/master/.travis.yml) with travis with no cases ignored.
|