{"id":13869827,"url":"https://github.com/ActivityWatch/aw-watcher-spotify","last_synced_at":"2025-07-15T18:32:02.377Z","repository":{"id":20875416,"uuid":"91162971","full_name":"ActivityWatch/aw-watcher-spotify","owner":"ActivityWatch","description":"Logs what you listen to on Spotify","archived":false,"fork":false,"pushed_at":"2024-08-24T16:21:17.000Z","size":61,"stargazers_count":75,"open_issues_count":13,"forks_count":9,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-07-13T10:29:33.549Z","etag":null,"topics":["activitywatch","activitywatch-watcher","spotify","spotify-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"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/ActivityWatch.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},"funding":{"github":["ActivityWatch"],"open_collective":"activitywatch","liberapay":"ActivityWatch","custom":["https://activitywatch.net/donate/"]}},"created_at":"2017-05-13T09:19:40.000Z","updated_at":"2025-07-11T01:17:36.000Z","dependencies_parsed_at":"2024-04-05T02:50:11.143Z","dependency_job_id":"4a651f2f-ed60-4860-adab-1a8832944ca5","html_url":"https://github.com/ActivityWatch/aw-watcher-spotify","commit_stats":{"total_commits":34,"total_committers":5,"mean_commits":6.8,"dds":0.1470588235294118,"last_synced_commit":"fe53cf6ca0ea8fc8ca23ce7ed03ec8fd44d4f643"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ActivityWatch/aw-watcher-spotify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-spotify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-spotify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-spotify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-spotify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ActivityWatch","download_url":"https://codeload.github.com/ActivityWatch/aw-watcher-spotify/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ActivityWatch%2Faw-watcher-spotify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265451451,"owners_count":23767768,"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":["activitywatch","activitywatch-watcher","spotify","spotify-api"],"created_at":"2024-08-05T20:01:18.824Z","updated_at":"2025-07-15T18:32:02.106Z","avatar_url":"https://github.com/ActivityWatch.png","language":"Python","readme":"aw-watcher-spotify\n==================\n\nWatches your currently playing Spotify track. This is on a per-user basis since it uses the Spotify Web API, so you don't need to run it on all your machines if you don't want the redundancy.\n\nThis watcher is currently in a early stage of development, please submit PRs if you find bugs!\n\n\n## Usage\n\n### Step 0: Create Spotify Web API token\n\nGo to [Spotify Developer Dashboard](https://developer.spotify.com/dashboard/applications) and create a new application.\n\nIn the app settings, add `http://localhost:8088` in the Redirect URIs section.\n\n### Step 1: Install package (using poetry)\n\nRequirements: Requires that you have poetry installed.\n\nFirst install the package and its dependencies:\n\n```sh\npoetry install\n```\n\nFirst run (generates empty config that you need to fill out):\n\n```sh\npoetry run aw-watcher-spotify\n```\n### Step 1: Install package (without poetry, using only pip)\n\nInstall the requirements:\n\n```sh\npip install .\n```\n\nFirst run (generates empty config that you need to fill out):\n```sh\npython aw-watcher-spotify/main.py\n```\n\n### Step 2: Enter credentials\n\nIf this is the first time you run it on your machine, it will give you an error, this is normal.\nJust fill in the config file (the directory is referenced in the error).\n\nRun the script again and...\nYou're done! Try playing a song on Spotify on any of your devices and it should start logging (provided they are not in offline mode).\n\n\n## Note\n\nEven without using this watcher, you can get a full export of the last year of listening history by requesting an export directly from Spotify here: https://www.spotify.com/us/account/privacy/\n\nThe export contains, among other things:\n\n- **Streaming history for the past year**\n- Playlists\n- Search queries\n- A list of items saved in your library\n- User data\n- Inferences\n\n(thanks [@oreHGA](https://github.com/oreHGA) for the tip!)\n","funding_links":["https://github.com/sponsors/ActivityWatch","https://opencollective.com/activitywatch","https://liberapay.com/ActivityWatch","https://activitywatch.net/donate/"],"categories":["Python","Media Watchers :musical_note:"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FActivityWatch%2Faw-watcher-spotify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FActivityWatch%2Faw-watcher-spotify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FActivityWatch%2Faw-watcher-spotify/lists"}