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

🔄 Manual Update

1. Close SP Video Courses Player completely
2. Download the latest .zip archive from the Releases page
3. Extract the archive into the application folder with file replacement

Note: Your personal data is preserved during the update — settings.ini contains your application settings, and the data/ folder stores the database, viewing progress, bookmarks, and cache. These files are not included in the release archive and will not be overwritten.

📋 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

🖼️ PureRef Integration (Optional)

To use the PureRef integration feature for managing reference images alongside your video courses:

1. Download and Install PureRef from https://www.pureref.com/download.php
2. Default Path: If installed to the default location (C:\Program Files\PureRef\PureRef.exe), the application will detect it automatically
3. Custom Path: If installed elsewhere, go to Library → Settings → PureRef section and browse to your PureRef.exe location
4. Filename: You can customize the reference filename (default: reference.pur) in the same settings section

Once configured, you'll see PureRef badges on folder items in your library, allowing quick access to reference files.

---

🇷🇺 Русский

Обзор

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

🔄 Ручное обновление

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

Примечание: Ваши личные данные сохранятся при обновлении — settings.ini содержит настройки приложения, а папка data/ хранит базу данных, прогресс просмотра, закладки и кеш. Эти файлы не входят в архив релиза и не будут перезаписаны.

📋 Требования

• Операционная система: 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

🖼️ Интеграция с PureRef (опционально)

Для использования интеграции с PureRef для управления референсами рядом с видеокурсами:

1. Скачайте и установите PureRef с https://www.pureref.com/download.php
2. Путь по умолчанию: Если установлен в стандартное расположение (C:\Program Files\PureRef\PureRef.exe), приложение обнаружит его автоматически
3. Другой путь: Если установлен в другое место, перейдите в Библиотека → Настройки → PureRef и укажите путь к PureRef.exe
4. Имя файла: Вы можете настроить имя файла референсов (по умолчанию: reference.pur) в той же секции настроек

После настройки вы увидите значки PureRef на папках в библиотеке, позволяющие быстро открывать файлы референсов.

---

Made with ❤️ for video course enthusiasts