{"id":18746086,"url":"https://github.com/fscm/discogs2music","last_synced_at":"2025-04-12T21:33:32.666Z","repository":{"id":202050126,"uuid":"54713759","full_name":"fscm/discogs2music","owner":"fscm","description":"Update your Music app album ratings with your Discogs ratings.","archived":false,"fork":false,"pushed_at":"2022-01-03T16:36:34.000Z","size":42,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T16:11:24.009Z","etag":null,"topics":["discogs","discogs-api","music","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fscm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-03-25T11:04:30.000Z","updated_at":"2022-07-06T18:22:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"68f32080-ed71-4dc4-8f86-68ed8edb5405","html_url":"https://github.com/fscm/discogs2music","commit_stats":null,"previous_names":["fscm/discogs2music"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fscm%2Fdiscogs2music","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fscm%2Fdiscogs2music/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fscm%2Fdiscogs2music/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fscm%2Fdiscogs2music/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fscm","download_url":"https://codeload.github.com/fscm/discogs2music/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248636690,"owners_count":21137504,"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":["discogs","discogs-api","music","python","python3"],"created_at":"2024-11-07T16:20:51.289Z","updated_at":"2025-04-12T21:33:28.513Z","avatar_url":"https://github.com/fscm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# discogs2music\n\nUpdate your Music app album ratings with your Discogs ratings.\n\n## Synopsis\n\nThis tool will try to update the album or songs rating value of your Music app\nalbums by getting the rating of the same album from your Discogs collection.\n\nDifferences in album/songs titles and the usage of special characters on\nalbum/songs names may prevent the tool from recognizing the albums properly.\n\n## Getting Started\n\nThere are a couple of things needed for the tool to work.\n\n### Prerequisites\n\nPython, version 3.6 or above, needs to be installed on your local computer.\nYou will also need a Discogs account.\n\n#### Discogs\n\nA Discogs user account is required (to obtain the ratings from). You can\ncreate an account at [https://www.discogs.com/users/create](https://www.discogs.com/users/create)\nif you do not have one already.\n\nA Discogs personal token is also required. You can obtain one at\n[https://www.discogs.com/settings/developers](https://www.discogs.com/settings/developers)\n\n#### Python 3.x\n\nPython version 3.6 or above is required for the tool to work. Python setup can\nbe found [here](https://www.python.org/downloads/).\n\nThe following python modules are also required to run the tool:\n\n* appscript \u003e= 1.1.2\n* progress \u003e= 1.5\n* requests \u003e= 2.25.1\n\n### Build\n\nIt is recommended the use of a Python Virtual Environment (venv) to build this\ntool. The same Virtual Environment can also be used to run the tool.\n\nAll of the commands described bellow are to be executed on the root folder of\nthis project.\n\nA Virtual Environment can be created using the follow command:\n\n```\npython3 -m venv venv/\n```\n\nAfter creating the Virtual Environment the same will have to be activated, run\nthe following command to do that:\n\n```\nsource venv/bin/activate\n```\n\nTo build and run the tool some Python modules are required. These modules can\nbe installed using the following command:\n\n```\npip3 --quiet install --upgrade --requirement requirements.txt build\n```\n\nFinaly the Python package for this tool can be created with the command:\n\n```\npython3 -m build --wheel\n```\n\nAfter this you should endup with wheel file (`*.whl`) inside a folder called\n`dist`.\n\n### Installation\n\nThe tool can be install using the wheel file and pip3:\n\n```\npip3 --quiet install dist/discogs2music-*.whl\n```\n\n### Usage\n\n```\nusage: discogs2music [-h] -a APIKEY [-d DATAFILE] [--debug] [-l] [-o] [-q] [-s] [-v]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -a APIKEY, --apikey APIKEY\n                        discogs api key (default: None)\n  -d DATAFILE, --datafile DATAFILE\n                        path to the datafile (default:\n                        /Users/fscm/Documents/Projects/Active/discogs2music/discogs2music.json)\n  --debug               debug mode (default: False)\n  -l, --local           use local file only (does not query discogs for data) (default: False)\n  -o, --override        override local data (default: False)\n  -q, --quiet           quiet mode (default: False)\n  -s, --songs           update songs rating instead of album rating (default: False)\n  -v, --version         show program's version number and exit\n```\n\n## Contributing\n\n1. Fork it!\n2. Create your feature branch: `git checkout -b my-new-feature`\n3. Commit your changes: `git commit -am 'Add some feature'`\n4. Push to the branch: `git push origin my-new-feature`\n5. Submit a pull request\n\nPlease read the [CONTRIBUTING.md](CONTRIBUTING.md) file for more details on how\nto contribute to this project.\n\n## Versioning\n\nThis project uses [SemVer](http://semver.org/) for versioning. For the versions\navailable, see the [tags on this repository](https://github.com/fscm/discogs2music/tags).\n\n## Authors\n\n* **Frederico Martins** - [fscm](https://github.com/fscm)\n\nSee also the list of [contributors](https://github.com/fscm/discogs2music/contributors)\nwho participated in this project.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE)\nfile for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffscm%2Fdiscogs2music","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffscm%2Fdiscogs2music","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffscm%2Fdiscogs2music/lists"}