Skip to main content

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
  • curses library
  • requests library
  • dotenv library

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

  1. Create a Spotify Developer Account: Go to the Spotify Developer Dashboard and create an application
  2. Configure Application Settings: Make the following changes to the settings of your app:
    • Set APIs used to Web API
    • Add http://localhost:8888/callback to Redirect URIs
  3. 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

termify_py-1.0.1.tar.gz (22.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

termify_py-1.0.1-py3-none-any.whl (24.3 kB view details)

Uploaded Python 3

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

Hashes for termify_py-1.0.1.tar.gz
Algorithm Hash digest
SHA256 2701aad3a5cebb2d4771dc30f6f83a2245651ac8c5d83bb502675644c4d8c6d7
MD5 4a7337bfd54768a5a154f09270d89266
BLAKE2b-256 5a1d830e3c95273ab53a8eb9cfb0dfdd1a553ec3f583933ee492f0a4bd79cd0a

See more details on using hashes here.

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

Hashes for termify_py-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7ade64845cbac02d220af8099f5e2d086d9d4b339befaaee53341c99d6d0c50e
MD5 6bc371140dadb4df4ec64b48dd9b8604
BLAKE2b-256 d43648b84da046cd8b7a870eda89e78e1d4997857cc8bd7c4fafe647e83ed06c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page