{"id":22474722,"url":"https://github.com/jthistle/py3spotifystatus","last_synced_at":"2025-03-27T16:47:04.953Z","repository":{"id":127632054,"uuid":"576696294","full_name":"jthistle/py3spotifystatus","owner":"jthistle","description":"Widget for py3status bar to display the current Spotify song and artist","archived":false,"fork":false,"pushed_at":"2023-06-03T18:46:43.000Z","size":90,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-01T20:30:20.455Z","etag":null,"topics":["i3","i3status","py3status","spotify"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/jthistle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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-12-10T17:25:51.000Z","updated_at":"2024-07-18T23:53:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"d64aa69b-f2e0-4562-8ecb-cace31b589ac","html_url":"https://github.com/jthistle/py3spotifystatus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jthistle%2Fpy3spotifystatus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jthistle%2Fpy3spotifystatus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jthistle%2Fpy3spotifystatus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jthistle%2Fpy3spotifystatus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jthistle","download_url":"https://codeload.github.com/jthistle/py3spotifystatus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245888042,"owners_count":20688893,"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":["i3","i3status","py3status","spotify"],"created_at":"2024-12-06T13:10:28.678Z","updated_at":"2025-03-27T16:47:04.936Z","avatar_url":"https://github.com/jthistle.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# py3spotifystatus - Spotify widget for py3status bar for i3 window manager\n\n![The widget in operation](./res/banner.png)\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Examples](#examples)\n- [Changes in this version](#changes-in-this-version)\n- [Credits](#credits)\n\nThis is a widget for the py3status for i3 which displays the current Spotify song and artist, and the current progress through the song.\n\nThis is an updated verison of [rpieja's i3spotifystatus](https://github.com/rpieja/i3spotifystatus) (unmaintained since 2018). Bug reports and pull requests are welcome! I will attempt to respond as soon as possible.\n\n## Requirements\n\n* [py3status](https://py3status.readthedocs.io/en/latest/user-guide/installation/)\n* [Spotify desktop app](https://www.spotify.com/us/download/linux/) - web player is not enough\n* (optional) [FontAwesome for the desktop](https://fontawesome.com/download) if you want Spotify logo in status bar\n\nThe other requirements are dbus and Python 3, which you shouldn't need to worry about since they come bundled with most distros. You also need [i3](https://i3wm.org), obviously.\n\n## Installation\n\n* Clone repository to your preferred location\n* Update your `i3status.conf` with\n```conf\norder += \"external_script\"\n\n# ...\n\nexternal_script {\n    script_path = \"/path/to/i3spotifystatus/pystatus.py\"\n    cache_timeout = 1\n}\n```\n* (optional) keybindings can be added through i3 `config` file, e.g.\n```\nbindsym $mod+$alt+D exec /path/to/i3spotifystatus/sendCommand.sh playpause\n# etc.\n```\n\n## Configuration\n\nThere are some options you can set at the top of the `pystatus.py` script by editing it. They are documented in the script.\n\n## Examples\n\nWidget with all config options on, while playing:\n\n![Widget with all config options on, while playing](./res/1.png)\n\nWhile paused (and demonstrating non-latin song titles):\n\n![While paused](./res/2.png)\n\nShowing truncation of long song titles:\n\n![Showing truncation of long song titles](./res/3.png)\n\nWith song progress turned off:\n\n![With song progress turned off](./res/4.png)\n\n## Changes in this version\n\nIn this version I:\n\n* Added song progress to widget\n* Added podcast support\n* Added `sendCommand.sh` script, which can be used to remotely control the Spotify player, for example using i3 mod keybindings\n* Changed output format of `pystatus.py` to work with py3status\n* Updated colours to match current Spotify branding\n* Fixed multiple bugs\n\n## Credits\n\n[Original i3spotifystatus](https://github.com/rpieja/i3spotifystatus) by [rpieja](https://github.com/rpieja).\n\nOriginal credits:\n\n\u003eScript is based on sample wrapper commited on original i3status repository.\n\u003e\n\u003eAwk script by @csssuf.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjthistle%2Fpy3spotifystatus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjthistle%2Fpy3spotifystatus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjthistle%2Fpy3spotifystatus/lists"}