Музыкальный плеер на Python с Tkinter и PyGame

Человек играет на гитаре

Зачем этот материал и что вы получите

Быстрый рабочий пример музыкального плеера на Python.
Объяснение ключевых компонентов: Tkinter (GUI), PyGame.mixer (звук), модуль os (файловая система).
Практичные улучшения: управление громкостью, предыдущая/следующая дорожка, упаковка приложения для пользователей.

Важно: код ориентирован на локальное воспроизведение файлов (mp3/wav). Это не потоковый плеер и не медиасервер — он работает с локальной коллекцией аудиофайлов.

Необходимые модули и установка

Tkinter — стандартная GUI-библиотека для Python. На Windows и macOS обычно поставляется с Python. В Linux-пакет может называться python3-tk (apt/yum). Пример для Debian/Ubuntu:

sudo apt install python3-tk

PyGame — нужен модуль mixer для воспроизведения звука:

pip install pygame

Модуль os входит в стандартную библиотеку Python и дополнительной установки не требует.

Примечание: пытаться установить tkinter через pip обычно не нужно и не даст результата; используйте пакетный менеджер ОС или установщик Python с поддержкой Tk.

Короткая справка по ключевым понятиям

Tkinter: виджеты для оконного интерфейса (кнопки, метки, списки).
PyGame.mixer: модуль для загрузки и воспроизведения звуковых файлов. Поддерживает .wav, .ogg и часто .mp3 (зависит от платформы/кодеков).
os.listdir / os.chdir: работа с файлами и текущей директорией.

Минимальный рабочий пример — класс MusicPlayer

Ниже собран связный пример, объединяющий описанные в статье части в один класс. В нём реализованы кнопки: Play, Pause, Unpause, Stop, а также список треков с прокруткой.

from tkinter import *
import pygame
import os

class MusicPlayer:
    def __init__(self, root):
        self.root = root
        self.root.title("Music Player")
        self.root.geometry("1000x200")

        pygame.init()
        pygame.mixer.init()

        self.track = StringVar()
        self.status = StringVar()

        # Frame для информации о треке
        trackframe = LabelFrame(self.root, text="Song Track", font=("arial", 15, "bold"), bg="#8F00FF", fg="white", bd=5, relief=GROOVE)
        trackframe.place(x=0, y=0, width=600, height=100)

        songtrack = Label(trackframe, textvariable=self.track, width=20, font=("arial", 24, "bold"), bg="#8F00FF", fg="#B0FC38")
        songtrack.grid(row=0, column=0, padx=10, pady=5)

        trackstatus = Label(trackframe, textvariable=self.status, font=("arial", 24, "bold"), bg="#8F00FF", fg="#B0FC38")
        trackstatus.grid(row=0, column=1, padx=10, pady=5)

        # Frame с кнопками управления
        buttonframe = LabelFrame(self.root, text="Control Panel", font=("arial", 15, "bold"), bg="#8F00FF", fg="white", bd=5, relief=GROOVE)
        buttonframe.place(x=0, y=100, width=600, height=100)

        Button(buttonframe, text="PLAY", command=self.playsong, width=6, height=1, font=("arial", 16, "bold"), fg="navyblue", bg="#B0FC38").grid(row=0, column=0, padx=10, pady=5)
        Button(buttonframe, text="PAUSE", command=self.pausesong, width=8, height=1, font=("arial", 16, "bold"), fg="navyblue", bg="#B0FC38").grid(row=0, column=1, padx=10, pady=5)
        Button(buttonframe, text="UNPAUSE", command=self.unpausesong, width=10, height=1, font=("arial", 16, "bold"), fg="navyblue", bg="#B0FC38").grid(row=0, column=2, padx=10, pady=5)
        Button(buttonframe, text="STOP", command=self.stopsong, width=6, height=1, font=("arial", 16, "bold"), fg="navyblue", bg="#B0FC38").grid(row=0, column=3, padx=10, pady=5)

        # Frame со списком воспроизводимых файлов
        songsframe = LabelFrame(self.root, text="Song Playlist", font=("arial", 15, "bold"), bg="#8F00FF", fg="white", bd=5, relief=GROOVE)
        songsframe.place(x=600, y=0, width=400, height=200)

        scroll_y = Scrollbar(songsframe, orient=VERTICAL)
        self.playlist = Listbox(songsframe, yscrollcommand=scroll_y.set, selectbackground="#B0FC38", selectmode=SINGLE, font=("arial", 12, "bold"), bg="#CF9FFF", fg="navyblue", bd=5, relief=GROOVE)

        scroll_y.pack(side=RIGHT, fill=Y)
        scroll_y.config(command=self.playlist.yview)
        self.playlist.pack(fill=BOTH)

        # Загрузка треков из папки
        # Замените Path_to_your_songs_folder на путь к вашей папке с музыкой
        os.chdir("Path_to_your_songs_folder")
        songtracks = os.listdir()
        for track in songtracks:
            self.playlist.insert(END, track)

    def playsong(self):
        try:
            selected = self.playlist.get(ACTIVE)
            self.track.set(selected)
            self.status.set("-Playing")
            pygame.mixer.music.load(selected)
            pygame.mixer.music.play()
        except Exception as e:
            self.status.set("-Error")
            print("Ошибка при воспроизведении:", e)

    def stopsong(self):
        self.status.set("-Stopped")
        pygame.mixer.music.stop()

    def pausesong(self):
        self.status.set("-Paused")
        pygame.mixer.music.pause()

    def unpausesong(self):
        self.status.set("-Playing")
        pygame.mixer.music.unpause()

if __name__ == '__main__':
    root = Tk()
    MusicPlayer(root)
    root.mainloop()

Пояснения к коду

Инициализация PyGame и mixer: pygame.init(); pygame.mixer.init(). Без инициализации mixer воспроизведение не начнётся.
StringVar() используется для динамического обновления текста в метках.
Listbox + Scrollbar — стандартный способ показать список треков с вертикальной прокруткой.
os.chdir(“Path_to_your_songs_folder”) — смена рабочей директории. Вместо этого можно собирать полный путь файлов через os.path.join и не менять cwd.

Совет: в рабочем проекте лучше хранить пути в абсолютном виде, чтобы не зависеть от текущей директории процесса.

Улучшения и практические расширения (варианты)

Управление громкостью:

# пример регулировки громкости (0.0 - 1.0)
pygame.mixer.music.set_volume(0.7)

Добавьте слайдер Tkinter Scale, который вызывает set_volume при изменении.

Кнопки “Следующая” и “Предыдущая”: храните индекс текущего трека и переключайтесь по индексу.
Асинхронность и отзывчивость UI: PyGame.mixer.play не блокирует интерфейс, но если будете добавлять обработку больших библиотек или сканирование файлов — выполняйте это в отдельном потоке (threading) или в фоновой задаче.
Поддержка форматов: для уверенной поддержки mp3 на некоторых ОС понадобится установить кодеки (например, ffmpeg/avlib). Рекомендуется использовать .wav или .ogg для совместимости без внешних зависимостей.
Drag & Drop и динамическое добавление треков: можно реализовать добавление файлов в плейлист перетаскиванием или через диалог выбора файлов (filedialog).
Экспорт/импорт плейлистов (.m3u): сохраните список файлов в текстовый плейлист и загружайте его при старте.

Альтернативные подходы

Pyglet — лёгкий вариант для звука/графики, преимущество: меньше зависимостей, простота работы со звуком.
Kivy — для кроссплатформенных мобильных/тач-интерфейсов (Android/iOS).
Использовать медиабиблиотеки высокого уровня (gstreamer, vlc-python) для более сложных сценариев и потокового воспроизведения.

Когда PyGame подходит: для простого локального плеера и игр с простыми звуковыми эффектами. Когда не подходит: если нужен продвинутый контроль кодеков или стриминг.

Тесты и критерии приёмки

Критерии приёмки:

Плеер загружает плейлист из указанной папки и показывает все файлы.
Нажатие Play запускает выбранный трек и отображает его имя и статус “-Playing”.
Pause приостанавливает воспроизведение; Unpause восстанавливает.
Stop полностью прекращает воспроизведение.
Список прокручивается и не теряет позицию при загрузке большого числа треков.

Минимальные тест-кейсы:

Открыть приложение с пустой папкой: приложение не должно падать.
Попытка воспроизвести файл неподдерживаемого формата: приложение показывает ошибку, не крашится.
Быстрая последовательность Play/Stop/Pause: плеер устойчив.

Рольовые чеклисты

Developer:

Настроить окружение и зависимости.
Реализовать переходы состояния (Playing, Paused, Stopped).
Добавить обработку ошибок при загрузке трека.

QA:

Тестирование клeймов CRITICAL (запуск/остановка/пауза).
Тестирование на разных ОС (Windows/macOS/Linux).

User:

Убедиться, что треки находятся в папке и видны в списке.
Проверить громкость и формат файла.

Отладка и распространённые проблемы

Ошибка при инициализации mixer: проверьте, доступен ли аудиодевайс в системе и инициализирован ли PyGame.
mp3 не воспроизводится: на некоторых платформах mp3 требует внешнего кодека; протестируйте с .wav или .ogg.
Неправильная текущая директория: используйте абсолютные пути или диалог выбора файлов.

Локализация и особенности платформ

Windows: пути с обратными слешами (). Используйте os.path.join и raw-строки для надёжности.
macOS/Linux: пакеты Tk могут устанавливаться отдельно (python3-tk).
При сборке в исполняемый файл (PyInstaller) убедитесь, что PyGame-модуль и медиа-файлы включены в сборку.

Конфиденциальность и безопасность

Приложение работает с локальными файлами и по умолчанию не передаёт данные в сеть.
Если реализуете функцию сканирования сети или загрузки метаданных — явно укажите политику приватности и минимизируйте отправку личных данных.

Короткий глоссарий (1 строка на термин)

Tkinter: стандартный GUI-фреймворк Python для настольных приложений.
PyGame.mixer: модуль PyGame для загрузки и воспроизведения звуков.
Listbox: виджет Tkinter для отображения списка элементов с выбором.

Примеры приложений с PyGame

PyGame часто используется для простых 2D-игр: Flappy Bird, Snake, музыкальные игры и прототипы. Для мобильных или 3D-проектов лучше рассмотреть Kivy, Pyglet или движки уровня Unity.

Интерфейс плеера на Python

Сводка

Простая архитектура: Tkinter — интерфейс, PyGame.mixer — звук, os — файловая система.
Проект легко расширяется: управление громкостью, переходы треков, плейлисты.
Тесты и критерии приёмки помогут убедиться в стабильности на разных платформах.

Важное: начните с небольшого набора треков и добавляйте функции по мере необходимости — так вы быстрее получите рабочую версию и сможете постепенно улучшать UX и совместимость.