musikcube

Q: How to fix 'avcodec_close' undeclared when building musikcube with FFmpeg 8.0?

Upgrade musikcube to the latest release or current `master` branch; the FFmpeg 8.0 compatibility fixes, including removal/replacement of the removed `avcodec_close` API, have been released. If using FreeBSD Ports, update the ports tree and upgrade `multimedia/musikcube`. For a source build, run `git fetch --tags && git checkout master && git pull`, then clean and rebuild (for example: `rm -rf build && cmake -S . -B build && cmake --build build -j$(nproc)`). Musikcube 3.0.4 is known to fail against FFmpeg 8.0.

SHA-256

4.8k stars·System Optimization·SHA-256 checksum verified

musikcube is a terminal-based cross-platform music player and streaming server. It runs on Windows, macOS, Linux, and Raspberry Pi, with an optional Android remote control app.

Smart Download

Download Download Version

v3.0.5 · 13.2 MB

A terminal-based cross-platform music player and streaming server that runs even on Raspberry Pi.

Core Features

Full terminal UI (TUI) with low resource usage, ideal for Raspberry Pi or headless servers
Supports many audio formats via FFmpeg
Built-in HTTP/WebSocket streaming server for remote control and audio streaming
Android companion app (musikdroid) for wireless control
Cross-platform: Windows, macOS, Linux, FreeBSD, OpenBSD

What It Can't Do

•The streaming server is not secure by default (plain text password, no SSL). Do not expose directly to the internet without a reverse proxy that provides HTTPS. The password is stored in plain text in the settings file.

Use Cases

Turn a Raspberry Pi into a home audio server, control via phone
Manage a local music library from a terminal-only environment
Modern alternative to cmus or mpd with a cleaner interface and streaming capabilities

Detailed Introduction

musikcube is a terminal-based music player and streaming server that works across Windows, macOS, Linux, and even Raspberry Pi. It provides a full-featured audio engine with support for multiple formats via FFmpeg, a clean TUI interface using ncurses, and an optional streaming server for remote control and audio playback. The application includes an Android companion app (musikdroid) for wireless control. It can be compiled from source or installed via package managers like Homebrew, Chocolatey, and pkg. The server uses WebSocket and HTTP on separate ports, but note it is not secure by default—SSL termination via a reverse proxy is recommended for internet exposure.

Troubleshooting & FAQ (2)

Troubleshooting

Why won't musikcube play .MP3 or .WAV files with uppercase extensions on Windows?

This was caused by case-sensitive file extension matching in musikcube; uppercase .MP3/.WAV files were ignored even though lowercase .mp3/.wav files worked. Upgrade to musikcube 0.92.0 or later, where the bug is fixed. For versions before 0.92.0, rename the files to lowercase extensions (for example, .MP3 to .mp3). If duplicate or stale entries remain after renaming, remove the music folder from the library, add it again, and rebuild the index.

GitHub Issue #349

Troubleshooting

How to fix 'avcodec_close' undeclared when building musikcube with FFmpeg 8.0?

Upgrade musikcube to the latest release or current master branch; the FFmpeg 8.0 compatibility fixes, including removal/replacement of the removed avcodec_close API, have been released. If using FreeBSD Ports, update the ports tree and upgrade multimedia/musikcube. For a source build, run git fetch --tags && git checkout master && git pull, then clean and rebuild (for example: rm -rf build && cmake -S . -B build && cmake --build build -j$(nproc)). Musikcube 3.0.4 is known to fail against FFmpeg 8.0.

GitHub Issue #736

Getting Started

Download installer

Click the button above to download the installer for your system

Linux· 13.2 MB Windows· 14.9 MB macOS· 14.4 MB

Install the software

Install the appropriate package for your distro (dpkg / rpm / AppImage)

Download the release archive or install via package manager (e.g., brew install musikcube)

Extract and run musikcube (or launch from terminal)

Navigate folders with arrow keys, press Enter to play, press ? for help

Install Guide

Download the release archive or install via package manager (e.g., brew install musikcube)
Extract and run musikcube (or launch from terminal)
Navigate folders with arrow keys, press Enter to play, press ? for help

File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

9c908eacc4b3d0bf494bc0a72048a9f3bb59ed6471c4571da8f5441e277fc883

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source

Environment Guide

Uninstall Info

Uninstall via package manager (e.g., brew uninstall musikcube) or delete the installation directory. Remove config at ~/.config/musikcube or ~/.musikcube if needed.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info

LicenseGPL-3.0

Last Updated2026-10-15 06:50:20

GitHub Repository

Having issues? Check the FAQ below

2 FAQs

Similar Projects

terminal

Modern, feature-rich terminal application for Windows command-line users, with tabs, GPU acceleration, and full customization.

core

Open source home automation that puts local control and privacy first. Perfect for Raspberry Pi or a local server.

PowerToys

A set of utilities for power users to tune and streamline their Windows experience for greater productivity.