58 lines
2.5 KiB
ReStructuredText
58 lines
2.5 KiB
ReStructuredText
Getting Started
|
|
===============
|
|
|
|
The goal of this app is automate the downloading and metadata creation of audio and video files, then place the files
|
|
in a directory that gets read by your media player/server. Everyone stores and watches their media differently, so
|
|
we strive for comprehensive and simplistic customization to fit all self-hosting needs.
|
|
|
|
Audio metadata is just a matter of adding tags to the audio file. The backend plugin we use supports practically every
|
|
common audio file type, so there should (hopefully) be no issues getting audio recognized by your media player.
|
|
|
|
Video metadata on the other hand, is currently geared toward generating Kodi/Jellyfin/Emby NFO files. Plex uses metadata
|
|
written within MP4 containers - we do not support that currently, but could be added as a plugin in the future.
|
|
|
|
Usage Ideas
|
|
-----------
|
|
Below is a list ways you can use ytdl-sub to download and consume different kinds of media in the representation you
|
|
prefer.
|
|
|
|
* Download a Youtube channel
|
|
* Store the channel as its own TV Show
|
|
* Use the channel's avatar as the TV Show poster, banner as the fanart
|
|
* Format the season and episodes as ``Season YYYY/sYYYY.eMMDD - Video Title.mp4`` to easily navigate videos by upload date
|
|
* Store the channel as a single season under a TV Show shared with other channels
|
|
* Only download audio, store it as a Podcast
|
|
* Only keep video/audio uploaded in the last `N` days
|
|
* Great for news or podcast based channels
|
|
|
|
* Download a Youtube playlist
|
|
* Download an artist's music videos playlist, store each video as a Kodi/Jellyfin/Emby Music Video
|
|
* Only download the audio, store the playlist as an album
|
|
|
|
* Manually download a single Youtube video
|
|
* Store it as a Movie
|
|
* Download a one-hit wonder and store it as a Kodi/Jellyfin/Emby Music Video
|
|
|
|
* Download a soundcloud artist's discography
|
|
* Add tags and album cover images so it shows up nicely in your music player
|
|
|
|
If you want to jump the gun to see how ytdl-sub can be configured to do these things, head over to the
|
|
:doc:`examples <examples>`.
|
|
|
|
Install
|
|
-------
|
|
Once we are ready for our first release, we will add this package to pypi. Then,
|
|
we plan to create a docker image that uses the
|
|
`LinuxServer.io <https://www.linuxserver.io/>`_
|
|
base image, and hopefully become a part of their fleet someday.
|
|
|
|
Until then, you will have to clone this repo and run it using python 3.10
|
|
|
|
.. code-block:: Bash
|
|
|
|
git clone https://github.com/jmbannon/ytdl-sub.git
|
|
cd ytdl-sub
|
|
|
|
pip install -e .
|
|
|
|
|