tejalonkar15/pybeats repository overview

⁠🐳 PyBeats – Dockerized MP3 Player

⁠📌 Description

PyBeats is a Python-based MP3 Player built using:

• 🎵 Pygame (audio playback)
• 🖥 Tkinter (GUI)
• 🐳 Docker containerized for portability

This image allows you to run the PyBeats MP3 Player inside a Docker container with GUI and audio support on Linux systems.

⁠🚀 Features

• Play MP3 audio files
• Simple Tkinter-based GUI
• SDL2 audio backend
• Dockerized environment with all dependencies pre-installed
• No local Python setup required

⁠📦 Image Details

• Base Image: python:3.12

• Includes:

  • SDL2 libraries
  • Tkinter
  • Audio device support

• Tag: 4.0

⁠🖥 Requirements

• Linux OS (tested on Ubuntu)
• X11 display server
• ALSA audio support
• Docker installed

⁠▶️ Run Instructions

Allow Docker to access display:

xhost +local:docker

Run container:

docker run \
  --device /dev/snd \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  tejalonkar15/pybeats:4.0

After running:

xhost -local:docker

⁠📂 Source Code

Available on GitHub: 👉 [https://github.com/tejalonkar/PyBeats⁠)

⁠⚠️ Notes

• This image is intended for Linux desktop environments.
• GUI applications inside Docker require X11 forwarding.
• Not intended for headless/server environments.