1 unstable release
0.1.0 | May 27, 2019 |
---|
#345 in #management
97KB
1.5K
SLoC
Sitch
Sitch keeps you updated on what you follow. It currently supports the following sources:
- YouTube channels
- RSS feeds
- Anime (myanimelist.net via Jikan)
- Manga (mangaeden.com API)
- Bandcamp artists
Sitch is written in Rust (stable).
Installation
To install sitch, you need to have rust
installed. Install the latest release by running the following
with the rust package manager, cargo
:
cargo install sitch
Usage
The usual way to run sitch is bare:
your@machine:~$ sitch
The following sources have updated since April 02, 2019 at 12:00 AM:
YouTube Channel - Northernlion: There have been 25 updates, the earliest was "Northernlion Plays - Katana Zero - Episode 6 [Rewind]" released on May 22, 2019 at 3:00 PM, found here: https://www.youtube.com/watch?v=0yXR8mUphuI [2 seconds]
YouTube Channel - Joseph Anderson: There have been 2 updates, the earliest was "Hollow Knight DLC - Swansong for Silksong" released on April 30, 2019 at 2:34 PM, found here: https://www.youtube.com/watch?v=Ece-wZ6VjFw [2 seconds]
YouTube Channel - Jacob Collier: There have been 3 updates, the earliest was "Jacob Collier - DJESSE World Tour: Recap" released on April 7, 2019 at 3:10 PM, found here: https://www.youtube.com/watch?v=m56mYgDkvSw [2 seconds]
Bandcamp - Disasterpeace: There has been 1 update, it was "Under the Silver Lake by Disasterpeace" released on April 19, 2019 at 12:00 AM, found here: https://music.disasterpeace.com//album/under-the-silver-lake [43 seconds]
Sitch will remember when you last ran it and check for updates since then, and let you know in a pretty format.
You can also run it with notifications (tested only on Linux):
sitch --notify
They are displayed in the following format:
+--------------------------------------+
| Sitch - <Source Name> |
| |
| First Update Title [Open in Browser] |
+--------------------------------------+
Configuration
To manage your sources, you can run the subcommands (e.g. rss
or youtube
) and they will explain how to manage them. You can
add, list, or bulk edit them. You can also search for anime,
manga, and YouTube channels. Try the following:
your@machine:~$ sitch youtube search
Search for an channel by name: Shnabubula
Found 5 results:
1: "Shnabubula" (id = UC9XtgFNeoDbjISzoJT0Qi9w)
2: "Shnabubula Archives" (id = UCAnR_x1Zw8QeOMKZNpPLmfA)
3: "Shnabubula - Topic" (id = UCafsTb5OoyWFAhDYvHvwrww)
4: "Red Tailed Fox & Shnabubula - Topic" (id = UClcNGxtDFYQ6koL5Diw-baw)
5: "Simply Retro DX" (id = UCW_quA3bcrfSl446z78Z0SQ)
Pick a result to add [1 to 5]: 1
Added a new channel.
Most of the sources are batteries included, but YouTube requires an API key for checking for updates and for using the search functionality. Sitch uses the YouTube API v3. You'll need to follow this link to get started. You can use the following to set your API key once you acquire one:
sitch youtube apikey set -k <YOUR KEY HERE>
If you don't set one, sitch will just ignore your YouTube channels until you set one.
License
Sitch is based on the MIT license.
Dependencies
~25–37MB
~650K SLoC