Make sure python3 is installed on your system then:
- Clone or download and extract the repository file:
git clone https://github.com/casualsnek/onethespot - Navigate to the onthespot directory
cd onethesport - Install the dependencies with
pip install -r requirements.txt - Launch the application with
python3 onthespot.py
Binary release are for windows will be worked on soon :). Note that it in early stage of development and features will be added . If you have ideas for improvement/features create a issue for discussion !
On first launch of application you might get a warning that no accounts are added and threads are not started. You can add your accounts by using login form at the bottom of 'Configuration' tab. You can add multiple accounts to be able to download multiple songs at a time without getting limited but might slow down application startups After adding accounts close and restart application and you should be good to go !
Click on 'OnTheSpot Search' tab then enter your search query and cick search to search for songs/artists/albums/playlists in spotify. You can then start downloading by cick on 'Download' button on the row of your search result. Note that Media Type other than 'Tracks' can take a little longer to parse and download. Application may appear to be frozen in this state but it is nothing to worry about ! You can bulk download particlar type of media like 'Albums', 'Tracks', etc, that appear on results table by clicking the download button below the results table.
Just enter the url in the url field then click download button, download should start. Note that Media Type other than 'Tracks' can take a little longer to parse and download. Application may appear to be frozen in this state but it is nothing to worry about !
Download status/progress can be viewed by navigating to 'Progress tabs'
- Max download workers : It is the number of downloaders available for parallel media downloads. It is recommended you set it to number of spotify accounts you have added in application. Changing this setting required application restart to take effect.
- Parsing Account SN : It is the Number shown at left side of username in Accounts table. The username corresponding to the SN is responsible for providing search results and parsing download url(s).
- Download Location : The root folder where downloaded medias are placed in. Click browse button next to it to set a new location to download files in.
- Download delay : Time in seconds to wait before next download after successful download.
- Max retries : Number of download retries to perform before giving up the download process.
- Max search results : The number of items to show in search result for each type of media. Example: Setting it to '1' shows one result for Artist, Album, Track and Playlist resulting in 4 total search results.
- Raw media download : Downloads files (ogg) directly from spotify server and writes to disk without converting to set media format, it also disables metadata writing and thumbnail embedding.
- Force premium : Use this is your premium accounts shows FREE in accounts table, this applies to all added accounts so it's not recommeded to use while using combination of free and premium accounts.
- Show/Hide Advanced Configuration: Enable/Disables the Advanced configuration tab
- Save setting : Saves the current setting and applies it to the application.
Note: Track name and album directory names are setup in this path format AlbumFormatter/TrackName
This option allows you to set naming scheme of downloaded tracks. It can also be a set as a path by using path seperator in the name
Variables can be used by enclosing them between {} . Few variables are available to set the naming scheme of tracks:
- artist : Name of artist of track.
- album : Name of album the track is in. *
- name : Name of track.
- rel_year : Release year of track.
- disc_number : Disk number in which track lies. *
- track_number : Serial Number of track in album. *
- spotid : ID of track as it is in spotify.
Example:
Song: {name} of album: {album} Released in {rel_year}The value of variables with their description ending in * maye be empty in some cases.
This option allows you set naming scheme of directory in which the tracks are downloaded and organised. This can be a path as well
Variables can be used by enclosing them between {} . Few variables are available to set the naming scheme of tracks:
- artist : Name of main artist of album
- rel_year: The relsease year if album. *
- album: Name of the album
Example: {artist}/{rel_year}/{album} downloads the track on folder with artist's name containing directory Release year then in the Album name directory
The value of variables with their description ending in * maye be empty in some cases.
Size of chunks in bytes in which the tracks are downloaded in.
Enabling this will disable popup dialog about status when using buld download buttons below the search results
Time to wait before retrying in case download fails due to Recoverable issues like network errors
Sometimes, last few bytes cannot be downloaded from spotify which causes 'PD Error' to show up and causes downloads to fail constantly, this sets up the number of bytes to skip downloading if this happens. The value might change but the current working vaue is '167' bytes. If you get 'Decode errors' or Incomplete song downloads try setting it to 0
If this is disabled the tracks downloaded from playlist/individual track URL or search results get placed in root of download directory instead of artist/album directories. Enabling this might cause slower download parsing but makes orgainsing music easier
Format of media you want your final music download to be in. ( Do not include '.' in it !). This setting gets ignore while using raw media download option
Decode error : If you are getting into this error, your account might have got restriction from spotify. Try removing it and add different one The application may crash frequently as there is no proper exception handling yet. You can help by opening a new issue wih error message displayed on your console window after the application misbehaves. The readme also needs to be written properly.
- Synced lyrics downloads
- Improve UI/UX ( Suggestions needed by users )
- Refactor code
- ....
Current readme can be hard to understand due to improprt emglish. You can improve user experience by improving it. You can write code to include additional feature or bug fixes or make a issue regarding bugs and features or just spread the work about the application :) If you want to support financially, you can visit Here and support through opencollective or BTC
If you like the project, show your support by giving it a star :) !
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent