{"id":13862422,"url":"https://github.com/akashrchandran/syrics","last_synced_at":"2025-04-05T22:06:12.868Z","repository":{"id":39990384,"uuid":"488330116","full_name":"akashrchandran/syrics","owner":"akashrchandran","description":"A command line tool to fetch lyrics from spotify and save it to lrc file. It can fetch both synced and unsynced lyrics from spotify.","archived":false,"fork":false,"pushed_at":"2023-11-28T17:54:46.000Z","size":85,"stargazers_count":192,"open_issues_count":5,"forks_count":14,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-29T21:07:02.259Z","etag":null,"topics":["hacktoberfest","lyrics","music","musixmatch","musixmatch-lyrics","python","python3","spotify","spotify-lyrics","spotify-web-api","spotipy"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akashrchandran.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-03T19:00:27.000Z","updated_at":"2025-03-28T18:11:38.000Z","dependencies_parsed_at":"2023-11-28T18:53:42.006Z","dependency_job_id":null,"html_url":"https://github.com/akashrchandran/syrics","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashrchandran%2Fsyrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashrchandran%2Fsyrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashrchandran%2Fsyrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akashrchandran%2Fsyrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akashrchandran","download_url":"https://codeload.github.com/akashrchandran/syrics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406087,"owners_count":20933803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","lyrics","music","musixmatch","musixmatch-lyrics","python","python3","spotify","spotify-lyrics","spotify-web-api","spotipy"],"created_at":"2024-08-05T06:01:44.030Z","updated_at":"2025-04-05T22:06:12.846Z","avatar_url":"https://github.com/akashrchandran.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003c!--\n Copyright (C) 2022 Akash R Chandran\n\n This program is free software: you can redistribute it and/or modify\n it under the terms of the GNU Affero General Public License as\n published by the Free Software Foundation, either version 3 of the\n License, or (at your option) any later version.\n\n This program is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n GNU Affero General Public License for more details.\n\n You should have received a copy of the GNU Affero General Public License\n along with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n--\u003e\n\n\n\u003cdiv align=\"center\"\u003e\n\n[![syrics logo](https://ik.imagekit.io/gyzvlawdz/Projects/syrics/Black_Modern_Business_Logo__600___500_px___2240___1260_px__cYRO9HGTQ.png)](https://pypi.org/project/syrics/)\n \n\u003c/div\u003e\n \n \u003cdiv align=\"center\"\u003e\n\nA command line tool to fetch lyrics from spotify and save it to lrc file. It can fetch both synced and unsynced lyrics from spotify. You can find API version at [akashrchandran/spotify-lyrics-api](https://github.com/akashrchandran/spotify-lyrics-api).\n \n\u003c/div\u003e\n \n \n## Getting started\n\n\u003e You will need a **spotify account**, free also works for some limited songs but it's nice to have premium.\n\n### Install with pip\n\n```\npip3 install syrics\n```\n### Upgrade with pip\n\n```\npip3 install syrics --upgrade\n```\n\u003e To get more detailed installation guide please check wiki's [installation page](https://github.com/akashrchandran/syrics/wiki/Installation)\n\n### Finding sp_dc\n\u003e Syrics sp_dc cookie to authenticate against Spotify in order to have access to the required services.\n\nThe methods are explained in the [wiki](https://github.com/akashrchandran/syrics/wiki/Finding-sp_dc).\n\n### Config\n\u003e When you run the program for the first time, it will directly create config and open editing.\n\n*To edit config*\n\n```\nsyrics --config\n```\n\n*To reset config to default values*\n\n```\nsyrics --config reset\n```\n*To open config in notepad or nano text editors*\n```\nsyrics --config open\n```\n\u003e After finding sp_dc you should edit config file and set sp_dc to the value you found.\n\n*Default values of config*\n\n```JSON\n{\n    \"sp_dc\": \"\",\n    \"download_path\": \"downloads\",\n    \"create_folder\": true,\n    \"album_folder_name\": \"{name} - {artists}\",\n    \"play_folder_name\": \"{name} - {owner}\",\n    \"file_name\": \"{track_number}. {name}\",\n    \"synced_lyrics\": true,\n    \"force_download\": false,\n    \"force_synced\": false\n}\n```\nSee wiki for more details about the format tag detailts in [config keys](https://github.com/akashrchandran/syrics/wiki/Config-Keys).\n\n### Usage\n\u003e Make sure you have set the congig before starting\n\n#### 1. Direct\n```\nsyrics\nEnter link: https://open.spotify.com/track/2eAvDnpXP5W0cVtiI0PUxV\n```\n __It will ask for the link__\n\n#### 2. Passing link as commandline argument\n```\nsyrics https://open.spotify.com/track/2eAvDnpXP5W0cVtiI0PUxV\n```\n__changing download folder command__\n```\nsyrics --directory ~/Music/songs/ https://open.spotify.com/track/2eAvDnpXP5W0cVtiI0PUxV\n```\n__download current playing song on authorized account__\n```\nsyrics --user current-playing\n```\n__downloading from user playlist__\n```\nsyrics --user playlist\n```\n__To see available commands__\n```\nsyrics -h\n```\n\n#### 3. Passing Folder path with music files (Experimental)\n\n```\nsyrics /home/public_user/Music/songs\n```\n\n### Use as a module\n\n```python\nfrom syrics.api import Spotify\nsp = Spotify(\"SP_DC here!\")\nsp.get_lyrics(\"28RQx5pH9T9LZXY02IheWc\")\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashrchandran%2Fsyrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakashrchandran%2Fsyrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakashrchandran%2Fsyrics/lists"}