SP Video Courses Player

Video player for local courses with hierarchical library, progress tracking, bookmarks, tags, and learning statistics. Includes video zoom, audio enhancement, custom subtitle settings, and instant thumbnail previews on the timeline

English • Русский

---

🇬🇧 English

Overview

SP Video Courses Player is a desktop application for watching and managing local video courses with hierarchical library organization, progress tracking, and learning statistics. Includes video zoom, audio enhancement, custom subtitle settings, and instant thumbnail previews on the timeline.

✨ Features

• 📚 Library Management - Hierarchical tree structure with Favorites and Tags filtering
• ▶️ Advanced Player - Built on libmpv with Picture-in-Picture (PiP) mode
• 🔊 Professional Audio Tools - AI Noise Reduction, Compressor, De-esser, Mono mix, and precise Sync Delay
• 📊 Detailed Statistics - Folder completion progress, watched duration, and remaining time
• 🔖 Smart Markers - Visual marker gallery, custom colors, and timeline previews
• 🖼️ Instant Previews - Hover over the timeline to see instantaneous video thumbnails
• 📝 Subtitle Support - Customizable subtitles with size, color, and outline settings
• ⏩ Speed Control - Adjust playback speed (0.5x - 3.0x) with pitch correction
• 🎨 Modern UI - Dark theme with custom icons and responsive layout

📖 Usage

1. Add Library Paths: Go to Library → Settings and add folders containing your video courses
2. Scan Library: Click Library → Scan to index your videos

🚀 Installation

Option 1: Download Executable (Recommended)

1. Download the latest release from the Releases page
2. Extract the archive to your desired location
3. Run SP Video Courses Player.exe

Option 2: Run from Source

1. Clone the repository:

   git clone https://github.com/yourusername/SPVideoCoursesPlayer.git
   cd SPVideoCoursesPlayer

2. Install dependencies:

   pip install -r requirements.txt

   📦 Dependencies:

   PyQt6
   python-mpv
   comtypes
   mutagen
   pyinstaller (for building)
   

3. Run the application:

   python main.py

📋 Requirements

• Operating System: Windows 10/11
• Python: 3.10+ (for source installation)

🔧 Additional Components

The application will automatically download these components on first run. If the automatic download fails, you can download them manually and place them in the resources/bin/ directory:

• libmpv-2.dll (Download from shinchiro or zhongfly) - MPV video playback library. Look for mpv-dev-x86_64-*.7z and extract the DLL.
• FFmpeg & FFprobe (Download Essentials) - For video analysis and thumbnail generation. Extract ffmpeg.exe and ffprobe.exe from the bin folder of the archive.

Placement: Place all components into the bin directory. The path depends on how you run the application:

The folder structure should look like this (for EXE version):

SP Video Courses Player/
├── SP Video Courses Player.exe
└── _internal/
    └── resources/
        └── bin/
            ├── libmpv-2.dll
            ├── ffmpeg.exe
            └── ffprobe.exe

---

🇷🇺 Русский

Обзор

SP Video Courses Player — плеер для локальных видеокурсов с древовидной библиотекой, сохранением прогресса, закладками, тегами и статистикой обучения. Включает масштабирование кадра, улучшение звука, настройку субтитров и мгновенные превью на таймлайне.

✨ Возможности

• 📚 Управление библиотекой — Древовидная структура с фильтрацией по Избранному и Тегам
• ▶️ Продвинутый плеер — На базе libmpv с режимом Картинка-в-картинке (PiP)
• 🔊 Профессиональный звук — AI Шумоподавление, Компрессор, Де-эссер, Моно-микс и точная настройка задержки
• 📊 Детальная статистика — Прогресс по папкам, просмотренное время и остаток
• 🔖 Умные закладки — Визуальная галерея маркеров, цветные метки и превью на таймлайне
• 🖼️ Мгновенное превью — Наведение на таймлайн показывает кадр из видео
• 📝 Поддержка субтитров — Настройка размера, цвета и обводки текста
• ⏩ Управление скоростью — Регулировка (0.5x - 3.0x) без искажения тона
• 🎨 Современный UI — Тёмная тема, адаптивный интерфейс и кастомные иконки

📖 Использование

1. Добавьте пути: Библиотека → Настройки — укажите папки с курсами
2. Сканирование: Библиотека → Сканировать — индексация файлов

🚀 Установка

Вариант 1: Скачать исполняемый файл (рекомендуется)

1. Скачайте последний релиз со страницы Releases
2. Распакуйте архив в нужное место
3. Запустите SP Video Courses Player.exe

Вариант 2: Запуск из исходников

1. Клонируйте репозиторий:

   git clone https://github.com/yourusername/SPVideoCoursesPlayer.git
   cd SPVideoCoursesPlayer

2. Установите зависимости:

   pip install -r requirements.txt

   📦 Зависимости:

   PyQt6
   python-mpv
   comtypes
   mutagen
   pyinstaller (for building)
   

3. Запустите приложение:

   python main.py

📋 Требования

• Операционная система: Windows 10/11
• Python: 3.10+ (для запуска из исходников)

🔧 Дополнительные компоненты

Приложение автоматически загрузит эти компоненты при первом запуске. Если автоматическая загрузка не удалась, вы можете скачать их вручную и поместить в директорию resources/bin/:

• libmpv-2.dll (Скачать от shinchiro или от zhongfly) — библиотека воспроизведения видео MPV. Ищите mpv-dev-x86_64-*.7z и извлеките DLL.
• FFmpeg и FFprobe (Скачать Essentials) — для анализа видео и генерации миниатюр. Извлеките ffmpeg.exe и ffprobe.exe из папки bin архива.

Путь: Поместите все компоненты в папку bin. Путь зависит от способа запуска приложения:

Структура папок должна выглядеть так (для EXE версии):

SP Video Courses Player/
├── SP Video Courses Player.exe
└── _internal/
    └── resources/
        └── bin/
            ├── libmpv-2.dll
            ├── ffmpeg.exe
            └── ffprobe.exe

---

Made with ❤️ for video course enthusiasts