A terminal-based Spotify controller
Project description
termify
Termify is a terminal-based application for controlling Spotify from the command line. With a simple and intuitive CLI, you can manage playback, view track details, and control your Spotify music without leaving the terminal.
Features
-
Playback control: Play, pause, skip, and change playback device
-
Track information: Get details about current song or podcast
-
Easy Navigation: Use arrow keys or Vim-style keybinds to navigate UI
Installation
Prerequisites
- Python 3.7 or higher
curseslibraryrequestslibrarydotenvlibrary
Create a Virtual Environment (Optional but reccomended)
This step can be safely skipped if you are already using a default virtual Environment.
python -m venv venv
source venv/bin/activate # On Windows use: venv\Scripts\activate
Install Termify
pip install termify-py
Configure Spotify Access
- Create a Spotify Developer Account: Go to the Spotify Developer Dashboard and create an application
- Configure Application Settings: Make the following changes to the settings of your app:
- Set
APIs usedtoWeb API - Add
http://localhost:8888/callbacktoRedirect URIs
- Set
- Copy or Take Note of Your
Client ID: You will need it when first launching termify
Usage
Running the Application
termify
Controls
Navigate through menus using arrow keys or Vim style keys (h, j, k, l)
Versioning
- Stable Versions: Available on PyPI. Install the latest stable version using
pip install termify - Unstable Versions: If you want to try the latest features or development version, you can install directly from source using
pip install .after cloning the repository. Be aware that this version may have new features or bugs not present in the stable release.
Contributing
Contributions are not only welcome, but encouraged! Feel free to fork the repository and submit pull requests. Be sure to review the CONTRIBUTING guidelines for more information on how to contribute to this project.
Get Involved
If you have any questions, suggestions, or feedback, please don't hesitate to open an issue or contact me.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file termify_py-1.0.1.tar.gz.
File metadata
- Download URL: termify_py-1.0.1.tar.gz
- Upload date:
- Size: 22.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2701aad3a5cebb2d4771dc30f6f83a2245651ac8c5d83bb502675644c4d8c6d7
|
|
| MD5 |
4a7337bfd54768a5a154f09270d89266
|
|
| BLAKE2b-256 |
5a1d830e3c95273ab53a8eb9cfb0dfdd1a553ec3f583933ee492f0a4bd79cd0a
|
File details
Details for the file termify_py-1.0.1-py3-none-any.whl.
File metadata
- Download URL: termify_py-1.0.1-py3-none-any.whl
- Upload date:
- Size: 24.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.12.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7ade64845cbac02d220af8099f5e2d086d9d4b339befaaee53341c99d6d0c50e
|
|
| MD5 |
6bc371140dadb4df4ec64b48dd9b8604
|
|
| BLAKE2b-256 |
d43648b84da046cd8b7a870eda89e78e1d4997857cc8bd7c4fafe647e83ed06c
|