Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/princeofpuppers/sync-dl-ytapi
An addon for sync-dl, providing commands which utilize the youtube api
https://github.com/princeofpuppers/sync-dl-ytapi
Last synced: 10 days ago
JSON representation
An addon for sync-dl, providing commands which utilize the youtube api
- Host: GitHub
- URL: https://github.com/princeofpuppers/sync-dl-ytapi
- Owner: PrinceOfPuppers
- License: mit
- Created: 2021-02-04T05:25:55.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-07-04T22:38:11.000Z (over 1 year ago)
- Last Synced: 2024-11-08T03:44:26.739Z (2 months ago)
- Language: Python
- Size: 2.76 MB
- Stars: 0
- Watchers: 4
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# sync-dl-ytapi
> An addon for sync-dl, providing commands which utilize the youtube api
- [INSTALLATION](#INSTALLATION)
- [ABOUT](#ABOUT)
- [USAGE](#USAGE)
- [EXAMPLE](#EXAMPLE)
- [DEVLOPMENT](#DEVLOPMENT)
# INSTALLATION
First install sync-dl:
```
pip install sync-dl
```
Using any commands in sync-dl which require this addon will prompt the user to install this addon.
# ABOUT
Provides sync-dl the ability to edit remote playlists on youtube through the youtube-api
# Usage
## Push Order Command:
```
sync-dl ytapi --push-order PLAYLIST
```
This will prompt you to install sync-dl-ytapi if you have not already, and will
print out the url to log in with google. Once you have done this it will
push the local order of PLAYLIST to youtube, reordering songs to match the local order (songs in remote but not in local will always stay after what they are currently after)
PLAYLIST is simply the name of the directory which contains the playlist. playlist directory will always be in current working directory unless a music directory is specified using the -l, --local-dir option to hard set a music directory.
You can also logout (revoke the access tokens and delete the saved credentials) using
the following command
```
sync-dl ytapi --logout
```
To see all options use the command:
```
sync-dl ytapi -h
```
## Transfer Command:
```
sync-dl ytapi transfer [OPTINOS] SRC_PLAYLIST DEST_PLAYLIST
```
Transfers songs between `SRC_PLAYLIST` and `DEST_PLAYLIST` on both local and remote, moving a single song using `-t SI DI` or a range of songs `-r S1 S2 DI`
To see all options as well as a more indepth description use the command:
```
sync-dl ytapi transfer -h
```
# DEVLOPMENT
To build for devlopment run:
```
git clone https://github.com/PrinceOfPuppers/sync-dl-ytapi.git
cd sync-dl-ytapi
pip install -e .
```
This will build and install sync-dl in place, allowing you to work on the code without having to reinstall after changes, it will also install sync-dl as it is a dependancy