mirror of https://github.com/chibicitiberiu/ytsm.git synced 2024-02-24 05:43:31 +00:00

Go to file

Tiberiu Chibici 3e835af295 Continued refactoring.		2019-12-23 23:52:38 +02:00
app	Continued refactoring.	2019-12-23 23:52:38 +02:00
assets	Added promotional image	2018-12-31 13:59:17 +02:00
config	Fixed registration step of first time setup. General improvements to settings and first time setup wizard.	2018-12-28 19:47:35 +02:00
docker	Added /media location to nginx, so it fetches the downloaded thumbnails.	2018-11-02 02:50:49 +02:00
examples/import_subscriptions	Added examples for supported import formats.	2018-11-03 14:58:19 +02:00
.gitignore	Ignored .idea workspace files.	2018-11-02 03:06:35 +02:00
Docker_README.md	Fix up Docker_README	2018-11-08 17:27:44 -08:00
docker-compose.yml	Removed unnecessary config volume.	2018-12-30 00:19:35 +02:00
Dockerfile	Removed unnecessary config volume.	2018-12-30 00:19:35 +02:00
LICENSE	Added license	2018-10-30 11:58:43 +02:00
README.md	Update README.md	2019-08-28 16:15:59 +03:00
requirements.txt	Began work on refactoring the YTSM application.	2019-12-16 22:19:50 +02:00

README.md

YouTube Subscription Manager

A self-hosted tool which manages your YouTube subscriptions, and downloads files automatically.

Current state

Currently, the program will do what it's main job is to do: download videos, and keep track of the subscriptions.

Of course, there are a lot of things that still need to be done. The web interface is still pretty limited, and there might still be uncaught bugs. These are some of the things that need to be done:

OAuth YouTube authentication, so private playlists can be obtained
Web UI improvements:
- Handle drag & drop for the subscription folders
- Update UI when something changes
Improve stability
Bonus: Plex integration
Bonus: Support for additional services (Twitch, Vimeo)

Dependencies

python3: $ apt install python3
pip: $ apt install python3-pip
ffmpeg: $ apt install ffmpeg
django: $ pip3 install django
crispy_forms: $ pip3 install django-crispy-forms
dj-config-url: $ pip3 install dj-config-url
youtube-dl: $ pip3 install youtube-dl
google-api-python-client: $ pip3 install google-api-python-client
google_auth_oauthlib: $ pip3 install google_auth_oauthlib
apscheduler (v3.5+): $ pip3 install apscheduler
(recommended) oauth2client: $ pip3 install oauth2client

Installation

There are 2 ways you can install this server. Using docker is the quickest and easiest method.

Normal installation for development/testing

Clone this repository:

git clone https://github.com/chibicitiberiu/ytsm.git
cd ytsm

Install all the dependencies listed above.

sudo apt install python3 python3-pip ffmpeg
sudo pip3 install --no-cache-dir -r requirements.txt

Modify config/config.ini to your liking. All the settings should be documented through comments. All these settings apply server-wide. The settings in the user section can be overriden from the web page for each individual user.
Obtain an YouTube API developer key from https://console.developers.google.com/apis/dashboard. You can find a detailed guide on this page.

The defaults.ini file already has an API key, but if the quotas are reached, you won't be able to use this program any more. Also, I might decide to delete that key, which will break your installation.

After obtaining the key, set it in config.ini.
Set up the database:
```
cd app
python3 manage.py migrate
```
By default, a SQLite database is used, which is located in the project's folder. The database can be configured in settings.ini.
Start the server: python3 manage.py runserver [port] --noreload --insecure

The port parameter is optional.

The --noreload option is necessary, otherwise the scheduler will run on 2 separate processes at the same time, which is not ideal.

The --insecure option is required only if Debug=False in config.ini, Without this option, the static resources (CSS, javascript) won't work.
Open the server's page in your browser, by entering http://localhost:port in your address bar.
Create an admin user by going to the register page, and creating an user account.
Add some subscriptions, and enjoy!

Docker

Clone this repository:

git clone https://github.com/chibicitiberiu/ytsm.git
cd ytsm

Install docker (if not installed)
Modify config/config.ini to your liking. All the settings should be documented through comments. All these settings apply server-wide. The settings in the user section can be overriden from the web page for each individual user.

Attention: you cannot modify the download location from settings.ini when using docker. To do so, you will need to modify the volume mapping in docker-compose.yml.
Obtain an YouTube API developer key from https://console.developers.google.com/apis/dashboard. You can find a detailed guide on this page.

The defaults.ini file already has an API key, but if the quotas are reached, you won't be able to use this program any more. Also, I might decide to delete that key, which will break your installation.

After obtaining the key, set it in config.ini.
Build and run docker compose image:
```
docker-compose up -d
```
Open the server's page in your browser, by entering http://localhost in your address bar.
Create an admin user by going to the register page, and creating an user account.
Add some subscriptions, and enjoy!

The docker image uses a sqlite database, and stores the data in a folder data/ located in the project directory. You can edit the default download locations in the docker-compose.yml file.

For more information about using Docker, check this page.

Deploying for production

This is a django project, so the correct way to deploy it to a server would be by using mod_wsgi. Since this project is still in development, I haven't really thought about getting it ready for production.

If you are willing to try that, you can find the information on how to deploy this application on the Django website.