Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bjarneo/Pytify
A CLI application for controlling Spotify
https://github.com/bjarneo/Pytify
spotify spotify-cli
Last synced: 8 days ago
JSON representation
A CLI application for controlling Spotify
- Host: GitHub
- URL: https://github.com/bjarneo/Pytify
- Owner: bjarneo
- License: mit
- Created: 2014-06-07T21:37:05.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-06-23T18:39:18.000Z (4 months ago)
- Last Synced: 2024-09-19T10:18:42.230Z (about 2 months ago)
- Topics: spotify, spotify-cli
- Language: Python
- Homepage:
- Size: 156 KB
- Stars: 743
- Watchers: 18
- Forks: 40
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- starred-awesome - Pytify - A CLI application for controlling Spotify (Python)
README
Pytify
=============
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4JDQMB6MRJXQE&source=url)
[](https://codeclimate.com/github/bjarneo/Pytify)
Search and start songs from the CLI.
Linux and OS X support.
*Spotify must be running in the background in order to use this cli remote*
Python 3 support. For Python 2 support use this release: [v2.1.0](https://github.com/bjarneo/Pytify/tree/v2.1.0)
## Installation
```bash
$ pip install pytify
```
Python 2
```bash
$ pip install pytify==2.1.0
```
Linux you need to install `python-dbus` package.
```bash
$ # Example using apt-get
$ apt-get install python-dbus
```
## Credentials
This package now must use credentials in order to search for songs.
Support for client credentials flow. Please follow these steps:
1. Register app: https://developer.spotify.com/my-applications/#!/applications
2. Edit your `~/.bashrc` to export following values:
```bash
export SPOTIPY_CLIENT_ID='your-spotify-client-id'
export SPOTIPY_CLIENT_SECRET='your-spotify-client-secret'
```
## Features
* Commands
* Auto suggest (based on history)
* Tab through history
* Search history
* Search and play songs
* CLI commands
* VIM navigation bindings
## Clone repo
```bash
$ git clone https://github.com/bjarneo/Pytify.git
$ cd Pytify
$ sudo python setup.py install
```
### Usage
```bash
# To start the app type
$ pytify
# next song
$ pytify -n
# prev song
$ pytify -p
# play and pause song
$ pytify -pp
# Current playing song
$ pytify -c
```
Commands
```
Commands:
current print current song
help list all commands
next play next song
pp play or pause song
stop stop
prev play previous song
history last five search results
```
### Install dev dependencies
pip version must be > 9
```bash
$ pip install -r requirements.txt
```
### Dependencies
```bash
* requests
* prompt-toolkit
```
### Contributing
Contributions are appreciated.
### Contributors
- [@joined](https://github.com/joined/) - OS X
- [@adam410](https://github.com/adam410/) - OS X issue
- [@Newky](https://github.com/Newky) - Better structure
- [@ymski](https://github.com/ymski) - OS X
- [@wohlfea](https://github.com/wohlfea) - Made it compatible with python 3.5
- [@ddiddi](https://github.com/ddiddi) - Added search phrase history browsing. (auto complete)
- [@kmatt](https://github.com/kmatt) - Minor UX changes
- [@bharath123](https://github.com/bharath-123) - Updated Pytify to use prompt_toolkit v2
- .... and other.. please add your name and code update!
### Logo
Logo by [theodorosploumis](https://github.com/theodorosploumis). Thank you very much!
## Donation
If this project has been helpful in any way, and you want to treat me a cup of coffee, please donate :)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4JDQMB6MRJXQE&source=url)