diff --git a/README.md b/README.md new file mode 100644 index 0000000..1a58c12 --- /dev/null +++ b/README.md @@ -0,0 +1,66 @@ +# sync-dl-gui +> An App for downloading and syncing remote playlists to your phone +- [ABOUT](#ABOUT) +- [DEVLOPMENT](#DEVLOPMENT) + +# ABOUT +Created to avoid having music deleted but still have the convenience of browsing, adding and reordering new music using remote services such as youtube. + +the application does not store any of its metadata in songs, metadata is stored next to them in a .metadata file, the music files are managed through numbering, allowing them to be played alphanumerically using any playback service (such as VLC) + + + +### Smart Sync: +The main feature of sync-dl Adds new music from remote playlist to local playlist, also takes ordering of remote playlist +without deleting songs no longer available in remote playlist. + +songs that are no longer available in remote, will remain after the song they are currently after in the local playlist + + + +# DEVLOPMENT + +## On Desktop + +``` +git clone https://github.com/PrinceOfPuppers/sync-dl-gui + +cd sync-dl-gui + +pip install -r requirements.txt + +python3 sync_dl_gui/main.py +``` + + +## On Mobile +install buildozer https://buildozer.readthedocs.io/en/latest/ + +install adb https://developer.android.com/studio/command-line/adb + +Enable developer mode on your smartphone and connect it to your computer via usb, be sure to enable usb debugging. +Test if connection is working using +``` +adb devices +``` + +Clone the project and setup logging + +``` +git clone https://github.com/PrinceOfPuppers/sync-dl-gui + +cd sync-dl-gui + +pip install -r requirements.txt + +adb logcat -s "python" > logs/logcat +``` + +In a seperate terminal run the following to build and push to your smartphone +``` +cd PATH_TO_SYNC-DL-GUI + +buildozer android debug update deploy run +``` +this should build, install and launch sync-dl-gui on your phone, however at times buildozer fails to auto launch +in which case just manually open the newly installed app. \ No newline at end of file diff --git a/privacy-policy.md b/privacy-policy.md new file mode 100644 index 0000000..4e7b12f --- /dev/null +++ b/privacy-policy.md @@ -0,0 +1,9 @@ +# Privacy +This Applications does not collect any user data, it does however connect to youtube +through youtube-dl, please see both of their policies below: + +## Youtube: +https://www.youtube.com/intl/ALL_ca/howyoutubeworks/policies/overview/ + +## youtube-dl: +https://github.com/ytdl-org/youtube-dl/blob/master/README.md \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..ba044b6 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,2 @@ +kivy +youtube-dl diff --git a/sync_dl_gui/assets/leaves2.jpg b/sync_dl_gui/assets/leaves2.jpg deleted file mode 100644 index 05f73ab..0000000 Binary files a/sync_dl_gui/assets/leaves2.jpg and /dev/null differ diff --git a/sync_dl_gui/assets/test.jpg b/sync_dl_gui/assets/test.jpg deleted file mode 100644 index 7c9aaa7..0000000 Binary files a/sync_dl_gui/assets/test.jpg and /dev/null differ diff --git a/sync_dl_gui/main.kv b/sync_dl_gui/main.kv index 1a8450c..9bd8636 100644 --- a/sync_dl_gui/main.kv +++ b/sync_dl_gui/main.kv @@ -13,7 +13,7 @@ FloatLayout: anchor_x: 'center' anchor_y: 'center' Image: - source: 'assets/test.jpg' + source: 'assets/leaves1.jpg' allow_stretch: True keep_ratio: True size_hint_y: None