{"id":14128670,"url":"https://github.com/pwittchen/spotify-cli-linux","last_synced_at":"2025-04-13T19:19:14.684Z","repository":{"id":45203171,"uuid":"83846694","full_name":"pwittchen/spotify-cli-linux","owner":"pwittchen","description":"A command line interface to Spotify on Linux","archived":false,"fork":false,"pushed_at":"2025-02-02T18:59:56.000Z","size":174,"stargazers_count":663,"open_issues_count":11,"forks_count":57,"subscribers_count":10,"default_branch":"develop","last_synced_at":"2025-04-06T17:01:34.736Z","etag":null,"topics":["cli","linux","python","shell","spotify","terminal"],"latest_commit_sha":null,"homepage":"https://pwittchen.github.io/spotify-cli-linux","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/pwittchen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":["pwittchen"],"custom":["https://paypal.me/pwittchen"]}},"created_at":"2017-03-03T22:20:47.000Z","updated_at":"2025-04-01T15:54:19.000Z","dependencies_parsed_at":"2024-11-07T20:45:07.344Z","dependency_job_id":"82d00c02-3d44-4553-8fd0-85eeebee33b0","html_url":"https://github.com/pwittchen/spotify-cli-linux","commit_stats":{"total_commits":227,"total_committers":18,"mean_commits":12.61111111111111,"dds":0.3083700440528634,"last_synced_commit":"bd967055c9f0a019ba4b6c38b79e9a288573bcd0"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwittchen%2Fspotify-cli-linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwittchen%2Fspotify-cli-linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwittchen%2Fspotify-cli-linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwittchen%2Fspotify-cli-linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pwittchen","download_url":"https://codeload.github.com/pwittchen/spotify-cli-linux/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248766685,"owners_count":21158302,"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":["cli","linux","python","shell","spotify","terminal"],"created_at":"2024-08-15T16:02:01.672Z","updated_at":"2025-04-13T19:19:14.666Z","avatar_url":"https://github.com/pwittchen.png","language":"Python","readme":"# spotify-cli-linux\n\n [![Build](https://github.com/pwittchen/spotify-cli-linux/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/pwittchen/spotify-cli-linux/actions/workflows/build.yml) [![Version](https://img.shields.io/pypi/v/spotify-cli-linux.svg?style=flat-square)](https://pypi.python.org/pypi/spotify-cli-linux/) [![Python versions](https://img.shields.io/pypi/pyversions/spotify-cli-linux.svg?style=flat-square)](https://pypi.python.org/pypi/spotify-cli-linux/)\n\nA command line interface to [Spotify](https://www.spotify.com/) on Linux.\n\nIf you're using macOS, see [spotify-cli-macos](https://github.com/pwittchen/spotify-cli-macos).\n\ninstallation\n------------\n\n```\npip install spotify-cli-linux\n```\n\n**hint #1**: if you encounter problems during installation, try to call command with `sudo`\n\n**hint #2**: if you still have problems (e.g. with resolving project dependencies), try to call `pip3` instead of `pip`\n\nif you have any problems with `pip` or `pip3`, you can try to install the script in the alternative way as a workaround:\n\n```\ngit clone git@github.com:pwittchen/spotify-cli-linux.git\ncd spotify-cli-linux\nsudo cp spotifycli/spotifycli.py /usr/local/bin/spotifycli\n```\n\nupgrade\n-------\n\n```\npip install spotify-cli-linux --upgrade\n```\n\nfor the upgrade, you can apply the same hints like for installation\n\nusage\n-----\n\nstart the official Spotify desktop app\n\nrun the following command from your terminal:\n\n```\nspotifycli\n```\n\nuse one of the following parameters:\n\n```\n-h, --help        show this help message and exit\n--version         shows version number\n--status          shows song name and artist\n--statusshort     shows status in a short way\n--statusposition  shows song name and artist, with current playback position\n--song            shows the song name\n--songshort       shows the song name in a short way\n--artist          shows artists name\n--artistshort     shows artist name in a short way\n--album           shows album name\n--arturl          shows album image url\n--lyrics          shows lyrics for the song playing\n--playbackstatus  shows playback status\n--position        shows song position\n--play            plays the song\n--pause           pauses the song\n--playpause       plays or pauses the song (toggles a state)\n--next            plays the next song\n--prev            plays the previous song\n--songuri OPENURI plays the track at the provided Uri\n--listuri OPENURI plays the playlist at the provided Uri\n--client CLIENT   sets client's dbus name\n```\n\nif you don't use any parameters, you'll enter the shell mode, where you'll be able to use all commands mentioned above\n\nsolving problems\n----------------\n\n### lyricwikia\n\nWhen, you're missing `lyricwikia` dependency, run the following command:\n\n```\npip install lyricwikia\n```\n\nusage with tmux\n---------------\n\nIf you want to use this script in your tmux panel, you can check [tmux-plugin-spotify](https://github.com/pwittchen/tmux-plugin-spotify).\n\ndevelopment\n-----------\n\nto install necessary tools for code formatting, static code analysis and releasing, run:\n\n```\nmake requirements\n```\n\ncode formatting\n---------------\n\nSource code should be formatted according to [PEP8](https://www.python.org/dev/peps/pep-0008/) style guides.\n\nTo format code, run:\n\n```\nmake format\n```\n\nto verify code formatting, type:\n\n```\nmake checkformat\n```\n\nstatic code analysis\n--------------------\n\nTo run static code analysis, execute:\n\n```\nmake lint\n```\n\ndocs\n----\n\nto update docs on `gh-pages`, type:\n\n```\nmake docs\n```\n\nto run docs locally, type:\n```\ngit checkout gh-pages \u0026\u0026 ./serve.sh\n```\n\nand view page with docs at: 0.0.0.0:8000\n\nview it on-line at https://pwittchen.github.io/spotify-cli-linux\n\nreleasing\n---------\n\ncurrently release is automated via `deploy.yml` GitHub Action, but it can be done manually too\n\nconfigure your `~/.pypirc` file as follows:\n\n```\n[distutils]\nindex-servers =\n    pypi\n[pypi]\nusername = __token__\npassword = VALID_TOKEN_GOES_HERE\n```\n\nthen, update version in `spotifycli/version.py` and `spotifycli/spotifycli.py` and type:\n\n```\nmake release\n```\n\n**note**: Version is not kept in a single file due to problems with importing files within another file and distributing them to PyPi. There are also Python vesion issues. If you know how to fix this issue properly to keep version in one place, I'd be happy to review your PR :-).\n","funding_links":["https://github.com/sponsors/pwittchen","https://paypal.me/pwittchen"],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpwittchen%2Fspotify-cli-linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpwittchen%2Fspotify-cli-linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpwittchen%2Fspotify-cli-linux/lists"}