sportfy / yark

YouTube archiving made simple.

Yark

YouTube archiving made simple.

Installation · Managing your Archive · Viewing your Archive

Yark lets you continuously archive all videos and metadata for YouTube channels and playlists. You can also view your archive as a seamless offline website ✨

Installation

To install Yark, simply download Python 3.9+ and FFmpeg (optional), then run the following:

$ pip3 install yark

Managing your Archive

Once you've installed Yark, think of a name for your archive (e.g., foobar) and copy the channel/playlist url:

$ yark new foobar https://www.youtube.com/channel/UCSMdm6bUYIBN0KfS2CVuEPA

Now that you've created the archive, you can tell Yark to download all videos and metadata using the refresh command:

$ yark refresh foobar

Once everything has been downloaded, Yark will automatically give you a status report of what's changed since the last refresh:

Viewing your Archive

Viewing you archive is easy, just type view with your archives name:

$ yark view foobar

This will pop up an offline website in your browser letting you watch all videos 🚀

Under each video is a rich history report filled with timelines and graphs, as well as a noting feature which lets you add timestamped and permalinked comments 👐

Light and dark modes are both available and automatically apply based on the system's theme.

Roadmap

Here's the general roadmap for Yark going a few months into the future for the upcoming features and changes:

1. Yark 1.3 (Current): Comments, viewer tabs, playlists, viewed
2. Yark 1.4 (Expected ??): Run command, better homepage, more graphs, translations
3. Yark 1.5 (Expected ??): Full GUI control for archives and viewer polish/rewrite
4. Onwards: Not sure yet, create an issue to help out :)

Details

Some things to keep in mind when using Yark; the good and the bad:

• Don't create a new archive again if you just want to update it, Yark accumulates all new metadata for you via timestamps
• Feel free to suggest new features via the issues tab on this repository
• Scheduling isn't a feature just yet, please use cron or something similar!