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.0.tar.gz (21.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.0.0-py3-none-any.whl (23.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: termify_py-1.0.0.tar.gz
  • Upload date:
  • Size: 21.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.0.0.tar.gz
Algorithm Hash digest
SHA256 75410203ad25b6d5b9688f3c6cfe1afdd56d24d78d720a43ce504e2691a32cb0
MD5 d99861f6c0a55cac190b3b66e32a04e0
BLAKE2b-256 26e9eeae3bf7dc75db2a40e2b59d7bfaec644f6eaeb0823dd2420c2cf5d9b6f2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: termify_py-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 23.7 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d0e840eec4bf3de43d64dfa8b07b8ca851428d95d8638814ab30db777ab1b332
MD5 8f18bdbb7527d9f2c8ae81a2a287e658
BLAKE2b-256 708f4052e75288e922882b7c369b1ddce7a97c55b8577ee38f3359a037f6baa6

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