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.

Demo of basic usage of termify

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 recommended)

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-py
  • 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.1.0.tar.gz (22.8 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.1.0-py3-none-any.whl (25.3 kB view details)

Uploaded Python 3

File details

Details for the file termify_py-1.1.0.tar.gz.

File metadata

  • Download URL: termify_py-1.1.0.tar.gz
  • Upload date:
  • Size: 22.8 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.1.0.tar.gz
Algorithm Hash digest
SHA256 d219d9a8a30595c69a0efb14200bc21a69d507e94b2cbb7d693970a616dc8f5e
MD5 c62239dbef3a9b26fc50360e68e982b6
BLAKE2b-256 4419e5ae702494b061563fe79f7d83a0f3e48d85d0137a11839524a166189c97

See more details on using hashes here.

File details

Details for the file termify_py-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: termify_py-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 25.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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 80ccab9e034bbb221f14d34060a90a6961559cfac9120794ad1c864fa32ad02c
MD5 f388c7d53adcaa3f53e17bd8458f5ccd
BLAKE2b-256 46337f47f6610de00e72a362a6a04167b2bf648df051bd7855f5fe58b48e8191

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