chibicitiberiu/ytsm
1
0
Fork 0
mirror of https://github.com/chibicitiberiu/ytsm.git synced 2024-02-24 05:43:31 +00:00
Code Issues Releases Wiki Activity

Updated readme

Browse Source
This commit is contained in:
Tiberiu Chibici 2018-11-02 03:24:49 +02:00
parent 6fd55920eb
commit 9dda2965be
1 changed files with 70 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
README.md
View File

@ -24,6 +24,7 @@ Of course, there are a lot of things that still need to be done. The web interfa
* python3: `$ apt install python3` * python3: `$ apt install python3`
* pip: `$ apt install python3-pip` * pip: `$ apt install python3-pip`
* ffmpeg: `$ apt install ffmpeg`
* django: `$ pip3 install django` * django: `$ pip3 install django`
* crispy_forms: `$ pip3 install django-crispy-forms` * crispy_forms: `$ pip3 install django-crispy-forms`
* dj-config-url: `$ pip3 install dj-config-url` * dj-config-url: `$ pip3 install dj-config-url`
@ -35,48 +36,55 @@ Of course, there are a lot of things that still need to be done. The web interfa
## Installation ## Installation
There are 2 ways you can install this server. Using docker is the quickest and easiest method.
### Normal installation for development/testing ### Normal installation for development/testing
1. Install all the dependencies listed above. 1. Clone this repository:
```bash
sudo apt install python3 python3-pip
sudo pip3 install apscheduler django django-crispy-forms dj-config-url youtube-dl google-api-python-client google_auth_oauthlib oauth2client
```
2. Clone this repository:
```bash ```bash
git clone https://github.com/chibicitiberiu/ytsm.git git clone https://github.com/chibicitiberiu/ytsm.git
cd ytsm/app cd ytsm
``` ```
3. Set up the database: `python3 manage.py migrate` 2. Install all the dependencies listed above.
By default, a SQLite database is used, which is located in the project's folder. ```bash
You can customize that in `YtManager/settings.py`, by modifying the `DATABASES` variable (search Django documentation for details). sudo apt install python3 python3-pip ffmpeg
sudo pip3 install --no-cache-dir -r requirements.txt
```
3. 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.
4. Obtain an YouTube API developer key from [https://console.developers.google.com/apis/dashboard](https://console.developers.google.com/apis/dashboard). 4. Obtain an YouTube API developer key from [https://console.developers.google.com/apis/dashboard](https://console.developers.google.com/apis/dashboard).
You can find a detailed guide on [this page](https://www.slickremix.com/docs/get-api-key-for-youtube/). You can find a detailed guide on [this page](https://www.slickremix.com/docs/get-api-key-for-youtube/).
The `defaults.ini` file already has an API key, but if the quotas are reached, you won't be able to use this program 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. any more. Also, I might decide to delete that key, which will break your installation.
After obtaining the key, set it in `config.ini`.
5. Modify `config/config.ini` to your liking. All the settings should be documented through comments. 5. Set up the database:
All these settings apply server-wide. The settings in the `user` section can be overriden from the web page for each
individual user.
The most important settings are: ```bash
cd app
* `[Global] YoutubeApiKey` - put your YouTube API key here python3 manage.py migrate
* `[User] DownloadPath` - sets the folder where videos will be downloaded ```
6. Start the server: `python3 manage.py runserver [port] --noreload` By default, a SQLite database is used, which is located in the project's folder. The database can be configured
in `settings.ini`.
6. Start the server: `python3 manage.py runserver [port] --noreload --insecure`
The `port` parameter is optional. The `port` parameter is optional.
The `--noreload` option is necessary, otherwise the scheduler will run on 2 separate processes at the same time, The `--noreload` option is necessary, otherwise the scheduler will run on 2 separate processes at the same time,
which is not ideal. 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.
7. Open the server's page in your browser, by entering `http://localhost:port` in your address bar. 7. Open the server's page in your browser, by entering `http://localhost:port` in your address bar.
@ -86,11 +94,46 @@ individual user.
### Docker ### Docker
A much easier way to install is to use Docker. 1. Clone this repository:
To run with docker, edit the config file (config/config.ini) and then run `docker-compose up -d`, it will bind to port 80. ```bash
git clone https://github.com/chibicitiberiu/ytsm.git
cd ytsm
```
You can edit the default download locations in the docker-compose.yml file. 2. Install docker (if not installed)
3. 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`.
4. Obtain an YouTube API developer key from [https://console.developers.google.com/apis/dashboard](https://console.developers.google.com/apis/dashboard).
You can find a detailed guide on [this page](https://www.slickremix.com/docs/get-api-key-for-youtube/).
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`.
5. Build and run docker compose image:
```bash
docker-compose up -d
```
6. Open the server's page in your browser, by entering `http://localhost` in your address bar.
7. Create an admin user by going to the *register* page, and creating an user account.
8. 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](Docker_README.md).
### Deploying for production ### Deploying for production