Skip to main content

It is currently not recommended to install catvibes via

Catvibes

A simple music player offering not only a terminal based frontend but also a Qt based one.

GUI

CLI

Installation

there is a package available on PyPI but just downloading an executable from the releases is recommended for now

    pip install Catvibes

Requirements:

in order to play music an existing installation of the VLC media player is required.

if the executable is used the following dependencies can be skipped

python and the following packages (will be installed as dependencies with pip):

pip install ytmusicapi eyed3 yt-dlp PyQt6

it also requires ffmpeg

On linux install ffmpeg which is available on debian-based and arch-based distros and probably already installed

On Windows follow this tutorial

Controls

GUI:

launch with the --gui flag

commandline:

f: find a song by typing a searchterm (ideally songname and bandname). Shows 3 results by default (select with the number keys).

esc: terminates searching usw and also exits the program

r: random shuffle, shuffles the queue randomly and adds the whole playlist to the queue when empty

p: play the whole playlist

a: add current song to the playlist

space: play / pause

n: next song

b: previous song

l: create a new playlist

Building the executables

I use pyinstaller to create the existing executables and the entire buildprocess is automated in the buildscript

the buildscript is written in bash (the default shell on nearly all Linux distributions) and also available on Windows via WSL. In order to produce the Windowsexecutables I use Wine with a default 64-bit Wineprefix which has python and the VLC media player installed (the creation of this prefix has to be done manually as the script wont do it for you). Due to the use of Wine I would not recommend trying to build the executables on Windows (emulating a linux environment emulating a Windows environment sounds pretty slow)

Metadata

Release files for Catvibes 1.0.22

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Catvibes 1.0.22
File Size Uploaded
catvibes-1.0.22.tar.gz 260.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Catvibes 1.0.22
File Interpreter ABI Platform
Catvibes-1.0.22-py3-none-any.whl Python 3 none any Details

Total release size: 301.3 kB

Release files / catvibes-1.0.22.tar.gz

Download URL catvibes-1.0.22.tar.gz
Size 260.5 kB
Tags Source
SHA-256 checksum
How to use checksums
4106f880f17598b8d4a260fd2beeff076df8c98d29d0ed494647288f9158ba5d
BLAKE2b-256 checksum
How to use checksums
70c0d993226da7f45948013793e400533b1276be238a74779bd49851416cfc10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.11.8

Release files / Catvibes-1.0.22-py3-none-any.whl

Download URL Catvibes-1.0.22-py3-none-any.whl
Size 40.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e31968b822483769f5cb2902d972a162287c120b6085dfcc66ad7bbe64010372
BLAKE2b-256 checksum
How to use checksums
583f6f2bf446d5c786d0dc45faa2cfa0a4259ce02628b2564722300b9adc1ec1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.11.8

Release history Release notifications | RSS feed

This release

1.0.22 This release

2 release files

1.0.21

2 release files

1.0.20

2 release files

1.0.19

2 release files

1.0.18

2 release files

1.0.17

2 release files

1.0.16

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page