FastMediaSorter v2 🚀
| 📖 Інші мови: 🇺🇸 English | 🇷🇺 Русский |
Про проект
FastMediaSorter v2 - це потужний Android-додаток для швидкого та зручного сортування медіафайлів (зображень, відео, GIF, аудіо, документів). Він спроектований як єдиний центр для керування файлами з різних джерел: локальні папки пристрою, мережеві диски (SMB, SFTP, FTP) та хмарні сховища (Google Drive, OneDrive, Dropbox).
Ключова ідея v2 - об’єднати перегляд, відтворення та організацію файлів в одному інтуїтивно зрозумілому інтерфейсі, усуваючи недоліки та обмеження попередньої версії.
Версія для Windows 🖥️
Шукаєте рішення для настільного комп’ютера? Спробуйте FastMediaSorter LITE - легкий додаток Windows Forms для швидкого сортування, перегляду та керування зображеннями та відео:
🔗 FastMediaSorter LITE для Windows
Особливості:
- Швидка навігація по великих папках із зображеннями та відео
- Режими слайд-шоу та випадкового перегляду
- Відстеження останніх файлів та папок
- Операції з файлами: переміщення, копіювання, перейменування та видалення
- Панель зображень для швидкої візуальної навігації
- Налаштовувані комбінації клавіш для ефективної роботи
- Багатомовна підтримка (Англійська/Російська)
- Підтримка Windows 7/10/11 з .NET Framework 4.8
Зміст
- Завантажити
- Версії додатку
- Ключові можливості
- Підтримувані медіаформати
- Скріншоти
- Сценарії використання
- Документація
- Wear OS Companion
- Інструкція зі збирання
- Тестування
- Перші кроки
- Технологічний стек
Версії додатку (Flavors) 🎯
FastMediaSorter v2 доступний у 4 різних версіях залежно від ваших потреб:
| Версія | Опис | Функції |
|---|---|---|
| Standard | Повнофункціональна версія | Найширший набір можливостей для медіа, документів, OCR та інтеграцій |
| Lite | Полегшена щоденна версія | Базові медіа-сценарії зі спрощеною конфігурацією |
| Photos | Версія з фокусом на зображення | Оптимізована для перегляду та сортування фото |
| Legacy | Версія для сумісності | Оптимізована для старих Android-пристроїв (API 23-25) |
Яку версію вибрати?
- Standard ⭐ (Рекомендується): Найкращий вибір за замовчуванням для більшості користувачів
- Lite: Підійде, якщо потрібен легший пакет і простіше налаштування
- Photos: Найкращий вибір для фото-орієнтованих сценаріїв
- Legacy: Обирайте для старих Android-пристроїв (API 23-25)
Для точної матриці можливостей за версіями використовуйте канонічні документи:
- Каталог можливостей (канонічний)
- How-To (таблиця доступності за версіями)
- Quick Start (вибір версії)
- Обмеження програми
Завантажити 📥
Доступно в GitHub Store - встановлення та оновлення безпосередньо з релізів на GitHub.
Скомпільовані APK файли НЕ зберігаються в цьому GitHub репозиторії. Всі збірки доступні в Google Drive:
🔗 Завантажити всі збірки з Google Drive
| Версія | Ім’я файлу | Опис |
|---|---|---|
| Standard | FastMediaSorter_standard_release.zip |
Повний функціонал (Хмара, OCR, EPUB) |
| Lite | FastMediaSorter_lite_release.zip |
Базова (Без хмари/аудіо) |
| Photos | FastMediaSorter_photos_release.zip |
Тільки зображення |
| Legacy | FastMediaSorter_legacy_release.zip |
Локальні медіа (Android 6.0+) |
Примітка: Всі збірки автоматично завантажуються в Google Drive після успішної компіляції.
🔐 Пароль від ZIP:
1(APK упаковані в захищені паролем архіви для обходу обмежень Google Drive)
Скріншоти 📱
| Main Screen | File Actions | Settings |
|---|---|---|
![]() |
![]() |
![]() |
| Player View | ||
![]() |
Зображення у повному розмірі:
Ключові можливості
- 🗂️ Єдиний інтерфейс: Перегляд та керування файлами з усіх джерел в одному вікні.
- ⚡ Швидке сортування: Копіюйте або переміщуйте файли до заздалегідь налаштованих папок-отримувачів одним натисканням.
- ⭐ Система вибраного: Позначайте важливі файли як вибрані та швидко отримуйте доступ до них зі спеціальної вкладки, яка агрегує вибране з усіх джерел.
- 🔒 Захист PIN-кодом: Захистіть окремі ресурси PIN-кодами доступу, щоб запобігти несанкціонованому перегляду та редагуванню.
- ⚙️ Налаштування ресурсів: Налаштовуйте інтервал слайд-шоу, глибину сканування (підпапки) та створення мініатюр для кожної папки індивідуально.
- 📋 Передвизначені розумні ресурси: Вбудовані віртуальні ресурси - Вся музика, Всі відео, Всі фото - агрегують медіафайли з усього пристрою без додаткового налаштування. Миттєвий доступ до повної медіатеки без ручного додавання папок.
- 🖥️ Підтримка мережі та хмари: Працюйте з файлами на ваших мережевих дисках (SMB), SFTP-серверах, FTP та у хмарних сховищах (Google Drive, OneDrive, Dropbox).
- 🖼️ Гнучкий перегляд: Відображення файлів у вигляді сітки, що налаштовується, або детального списку з підтримкою пагінації для великих колекцій (1000+ файлів).
- ▶️ Вбудований плеєр: Відтворення відео та аудіо, перегляд зображень та GIF без виходу з програми. Підтримує слайд-шоу та масштабування.
- 🧩 Інтеграція як плеєра за замовчуванням: Через опційні перемикачі відтворення FastMediaSorter може працювати системним обробником інтенів відкриття/шерінгу (ACTION_VIEW / ACTION_SEND), а також приймати пробудження аудіосервісу від апаратних медіа-кнопок.
- 🎛️ Підтримка апаратних кнопок: Кнопки керування на кермі, кнопки гарнітури та фізичні медіа-клавіші (Play/Pause, Next, Previous) повністю підтримуються через фоновий аудіосервіс - без необхідності торкатися екрана.
- 🎵 Текст пісень (Лірика): Перегляд тексту поточної пісні. Автоматичний пошук за метаданими (Виконавець/Назва) через
api.lyrics.ovhіз запасним варіантом пошуку за іменем файлу. - ✏️ Редагування зображень: Поворот, віддзеркалення, фільтри (відтінки сірого, сепія, негатив), налаштування яскравості/контрасту/насиченості - як для локальних, так і для мережевих файлів.
- ⌨️ Підтримка клавіатури та миші: Повна навігація з клавіатури (стрілки, гарячі клавіші Ctrl+A/C/X, F2, F5, Delete, Backspace) та підтримка миші (контекстне меню по правій кнопці, hover-ефекти, індикатори фокусу) для ChromeOS та desktop-режиму.
- 🔍 Сортування та фільтрація: Впорядковуйте файли за іменем, датою, розміром та тривалістю. Застосовуйте фільтри для швидкого пошуку.
- ↩️ Скасування та Кошик: Можливість скасувати останню дію (копіювання, переміщення, видалення) з функцією soft-delete до папки
.trash/. Включає функцію “Очистити кошик” для ресурсів. - 🎨 Сучасний інтерфейс: Підтримка світлої та темної тем, інтуїтивно зрозуміле керування, Material Design 3.
- 💾 Розумне кешування: Двоетапне завантаження метаданих відео (1МБ початкова, 5МБ розширена) та налаштовуваний кеш мініатюр (2ГБ за замовчуванням, до 16ГБ).
- 📄 Перегляд документів: Вбудований переглядач для текстових файлів (.txt, .md, .log, .json, .xml) та PDF документів з підтримкою масштабування, переміщення та навігації жестами.
- 📚 Читалка EPUB: Вбудована читалка електронних книг з навігацією по розділах, змістом, регулюванням розміру шрифту, пошуком по тексту та підтримкою світлої/темної теми. Працює з локальними та мережевими файлами.
- 🌐 Авто-переклад: Миттєвий переклад тексту із зображень, PDF і текстових файлів за допомогою Гібридної системи OCR (Google ML Kit + Tesseract) для високої точності як латиниці, так і кирилиці.
- 📱 Підтримка віджетів: Швидкий доступ до вибраних папок прямо з домашнього екрана за допомогою віджетів, що налаштовуються.
- ⏰ Заплановані операції: Автоматизуйте керування файлами за розкладом. Налаштуйте повторювані операції Копіювання, Переміщення або Видалення між будь-якими ресурсами (локальні, мережа, хмара) з фільтрами за типом файлів та часом. Операції виконуються у фоні через WorkManager навіть коли застосунок закрито.
- 👆 Продвинуті жести: Розумне масштабування зображень (2x/3x/4x) та інтуїтивні сенсорні зони для навігації файлами.
- 📸 Зберегти кадр: Знімок поточного кадру відео у PNG або JPG, зберігається у будь-який налаштований ресурс - локальний або мережевий. Формат і папка призначення задаються у Video Settings.
- 🖨️ Друк: Відправлення документів (PDF, TXT) і зображень на принтер прямо з вбудованого плеєра. Мережеві та хмарні файли попередньо кешуються.
- ⬇️ Stream Offload: Завантаження мережевого файлу у локальний кеш із діалогом прогресу перед відтворенням або під час нього. Після закінчення пропонується очистити кеш.
- 🔊 DTS/DTS-HD аудіо: Треки DTS і DTS-HD декодуються програмно через кастомну збірку FFmpeg - спеціального обладнання не потрібно.
- 🎨 Колір і яскравість відео: Регулювання відтінку (Hue) та яскравості (Brightness) у реальному часі через Media3 GPU-ефекти. Налаштування зберігаються між відеофайлами.
- 📤 Поділитися у FastMediaSorter: Приймання файлів з будь-якого застосунку через стандартний механізм «Поділитися» Android з наступним копіюванням у вибраний ресурс одним натисканням.
Підтримувані медіаформати 🎞️
FastMediaSorter v2 підтримує широкий спектр форматів:
- Зображення: JPG, JPEG, PNG, GIF, BMP, WEBP, HEIC, HEIF, AVIF
- Відео: MP4, MKV, MOV, WMV, FLV, WEBM, M4V, 3GP, MPG, MPEG, TS, M2TS, VOB, OGV, DIVX, MTS
- Аудіо: MP3, FLAC, AAC, OGG, M4A, WMA, OPUS, AMR, ALAC, CAF, MKA, OGA, AC3, MID, MIDI, DTS, DTS-HD
- Документи: TXT, MD, LOG, JSON, XML, PDF, EPUB
- Бінарні файли (режим “Всі файли”): ZIP, RAR, 7z, TAR, GZ, ISO, DMG, IMG, APK, EXE, DLL, SO та 60+ інших форматів
Сценарії використання 💡
Ось кілька способів, як FastMediaSorter v2 може вам допомогти:
1. 📸 Організація фотографій з камери
Підключіть телефон або відкрийте локальну папку з камерою. Налаштуйте папку призначення “Найкращі фото”. Відкрийте перегляд, швидко прогортайте тисячі фотографій та натискайте кнопку призначення, щоб миттєво копіювати найкращі знімки.
2. 🏠 Мережеве резервне копіювання (NAS)
Додайте ваш домашній NAS через SMB. Переглядайте локальні медіафайли. Виберіть кілька файлів або діапазон і перемістіть (“Move”) їх на NAS для збереження, звільняючи місце на пристрої.
3. ☁️ Керування хмарою
Підключіть обліковий запис Google Drive, OneDrive або Dropbox. Переглядайте хмарні файли без їх повного завантаження. Видаляйте непотрібні файли або організовуйте їх по папках прямо у хмарі.
4. 📺 Слайд-шоу та презентація
Відкрийте папку з сімейними фото або слайдами презентації. Натисніть “Play”, щоб запустити слайд-шоу. Використовуйте налаштування ресурсу, щоб відрегулювати тривалість показу слайдів.
5. ⭐ Управління обраним
Відмічайте важливі файли кнопкою “зірка” під час перегляду. Пізніше перейдіть на вкладку “Обране” в головному меню, щоб миттєво отримати доступ до всіх обраних файлів з усіх джерел в одному місці - ідеально для створення кураторської колекції найкращих медіа.
6. 🎶 Слайд-шоу з фоновою музикою
Додайте вашу музичну колекцію як ресурс. У Налаштуваннях → Аудіо увімкніть “Фонова музика для слайд-шоу” та виберіть ваш музичний ресурс. Тепер при запуску слайд-шоу ваших фотографій ваші улюблені треки гратимуть на фоні. Натисніть на назву треку, щоб переключитися на іншу випадкову пісню, створюючи ідеальну атмосферу для ваших фото-презентацій.
7. 🖼️ Цифрова Фоторамка на Планшеті
Перетворіть будь-який Android-планшет на красиву завжди ввімкнену цифрову фоторамку. Поставте його на підставку, підключіть до домашнього ПК (SMB) або хмари - фотографії транслюються напряму без зайняття локальної пам’яті. Налаштуйте інтервал зміни слайдів, увімкніть постійно активний екран, додайте фонову музику та насолоджуйтесь спогадами. Навіть старі бюджетні планшети чудово підходять для цієї мети - додаток оптимізований для тривалого відтворення з мінімальним навантаженням.
8. 🍿 Домашній Кінотеатр та VR
Дивіться серіали з комп’ютера або хмари прямо на телефоні чи у VR-шоломі. Не треба чекати копіювання або хвилюватися за вільне місце. Просто натисніть “Play” - наступна серія почнеться автоматично.
Сценарії для VR-шолома - FastMediaSorter запускається нативно на Android-шоломах (Meta Quest, Pico та аналогах) без жодних модифікацій:
- 🎬 Гігантський віртуальний кінотеатр: Відкрийте відео з домашнього NAS або хмари та дивіться його на віртуальному екрані розміром зі стіну. Не потрібно копіювати гігабайтні файли на шолом - додаток стримить напряму по домашній мережі. Коли одна серія закінчується, наступна запускається автоматично.
- 🎵 Іммерсивний музичний плеєр: Запустіть свою музичну колекцію у VR-середовищі. Фоновий аудіосервіс продовжує відтворення навіть при переключенні між додатками або відкритті головного екрана шолома. Апаратні кнопки шолома (відтворення/пауза, наступний трек) працюють без торкання контролера.
- 🖼️ Фоторамка розміром зі стіну у VR: Перетворіть VR-шолом на іммерсивний фотодосвід - запустіть слайд-шоу, і ваші фотографії заповнять величезну віртуальну стіну навколо вас. Додайте фонову музику для кінематографічного занурення у спогади. Стримте фото напряму з домашнього ПК або хмари - пам’ять шолома залишається вільною.
9. 🧹 Порядок у Завантаженнях
Папка “Downloads” переповнена? Відкрийте її як джерело, налаштуйте кнопки призначення для “Документів”, “Зображень” та “APK”. Швидко переглядайте файли та розкладайте їх по папках одним дотиком. Ви можете наводити лад навіть на віддаленому комп’ютері, використовуючи телефон як пульт керування.
10. 🚗 Музика в Автомобілі на Android-Магнітолі
Встановіть FastMediaSorter на автомобільну Android-магнітолу або головний пристрій. Додайте папки з музикою з USB-накопичувача або SD-карти - або скористайтеся вбудованим віртуальним ресурсом Вся музика для миттєвого доступу до всієї колекції без додаткового налаштування. Апаратні кнопки керування (кнопки на кермі, регулятори) працюють напряму через фоновий аудіосервіс: відтворення/пауза, наступний/попередній трек - без необхідності дивитися на екран. Додаток запам’ятовує позицію відтворення та автоматично відновлює її при запуску.
11. 📺 Медіацентр на Android TV-приставці
Встановіть FastMediaSorter на будь-яку Android TV-приставку (Xiaomi Mi Box, Nvidia Shield, Amazon Fire TV або дженерик Android-бокс). Підключіться до домашнього NAS через SMB, додайте Google Drive або Dropbox, або підключіть USB-накопичувач - усе в одному додатку. Керуйте повністю з пульта ДК або Bluetooth-клавіатури: D-pad переміщує фокус, OK відкриває елементи, Back повертає на рівень вище, Backspace піднімається на папку вгору в браузері файлів. Кольорові кнопки пульта призначені на найчастіші операції з файлами (Червона = Видалити, Зелена = Копіювати, Жовта = Перемістити, Синя = Перейменувати). Запустіть слайд-шоу з фоновою музикою на весь екран телевізора або увімкніть аудіо з відображенням обкладинок альбомів та текстів пісень. Тачскрін не потрібен жодного кроку.
Документація 📚
🗺️ Карта документації: Усі документи
🌐 Офіційний сайт: https://serzhyale.github.io/FastMediaSorter_mob_v2/
Канонічні джерела (Single Source of Truth)
Наступні файли є джерелом істини для користувацької документації:
- Повний перелік можливостей
- Карта документації
- Завантаження збірок (EN)
- How-To Guides
- Обмеження програми
- Швидкий старт
- Умови використання
Детальні керівництва доступні кількома мовами:
🇺🇦 Українська:
🇺🇸 English:
- How-To Guides
- Quick Start
- FAQ
- Troubleshooting
- Program Limitations
- Downloads Guide
- Complete Feature List
- Module Selection Guide
🇷🇺 Русский:
Technical / Developer Docs:
- Architecture Overview
- DevOps & Build Scripts
- Technology Stack
- Wear OS Documentation
- Open Source Components
Wear OS Companion ⌚
FastMediaSorter має companion-додаток для Wear OS, оптимізований під сценарії використання на смарт-годинниках.
- Перегляд і відтворення локальних медіа безпосередньо на Wear OS-пристроях
- UI та поведінка рантайму оптимізовані для компактних екранів круглої форми
- Окрема документація з інсталяції, збирання та налагодження Wear-сценаріїв
Документація Wear OS:
Інструкція зі збирання
Вимоги
-
Android Studio Hedgehog (2023.1.1) або новіше
- JDK 17+
- Android SDK 35
- Мінімальна версія Android: 8.0 (API 26) для Standard/Lite/Photos; 6.0 (API 23) для Legacy
Збирання
-
Клонуйте репозиторій:
git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git cd FastMediaSorter_mob_v2 - Відкрийте проект в Android Studio.
- Дочекайтеся закінчення синхронізації Gradle.
- Запустіть додаток на емуляторі або фізичному пристрої.
Рекомендовані команди збирання (Windows / PowerShell)
.\build-debug.PS1
.\gradlew.bat assembleStandardDebug
.\gradlew.bat testStandardDebugUnitTest
.\gradlew.bat lintStandardDebug
Тестування 🧪
FastMediaSorter v2 використовує Maestro для end-to-end тестування.
Швидкий запуск
# Windows (PowerShell)
.\maestro\run-tests.ps1 smoke
# Швидкий ярлик
.\scripts\utils\run-maestro-smoke.ps1
Документація з тестів:
CI workflow:
Перші кроки (Короткий посібник) 🚀
- Додавання папки (ресурсу):
- На головному екрані натисніть кнопку з іконкою “Плюс” (+), щоб додати новий ресурс.
- Виберіть тип ресурсу (наприклад, “Локальна папка”).
- Використовуйте сканування або додайте папку вручну. Після додавання вона з’явиться у списку на головному екрані.
- Перегляд файлів:
- Двічі торкніться (або зробіть довге натискання) на доданий ресурс у списку.
- Відкриється екран перегляду, де ви побачите всі медіафайли з цієї папки у вигляді списку або сітки.
- Використовуйте кнопки на верхній панелі для сортування, фільтрації або перемикання виду.
- Відтворення та сортування:
- Натисніть на будь-який файл, щоб відкрити його в повноекранному плеєрі.
- Використовуйте свайпи вліво/вправо або сенсорні зони для навігації між файлами.
- Для виконання операцій (копіювання, переміщення) використовуйте відповідні сенсорні зони або кнопки на панелі керування.
- Налаштування папок-отримувачів (Destinations):
- У налаштуваннях, на вкладці “Destinations”, ви можете вказати до 30 папок, які будуть використовуватися для швидкого сортування.
- Альтернативно, увімкніть опцію “Is Destination” (Є призначенням) у вікні редагування будь-якого ресурсу, щоб додати його до списку швидкого сортування.
- Після цього на екрані плеєра з’являться кнопки для швидкого копіювання або переміщення файлів у ці папки.
Технологічний стек
- Мова: Kotlin
- Архітектура: Clean Architecture, MVVM
- UI: Android View System (XML), Material Design 3
- Асинхронність: Kotlin Coroutines & Flow
- DI: Hilt (Dagger)
- База даних: Room (версія 6 з підтримкою хмарних провайдерів)
- OCR та Переклад: Google ML Kit (Розпізнавання тексту, Переклад), Tesseract4Android (OCR для кирилиці)
- Навігація: AndroidX Navigation Component
- Медіа: ExoPlayer (Media3 1.2.1)
- Зображення: Glide 4.15.1 з кастомним NetworkFileModelLoader
- Мережеві протоколи:
- SMB: SMBJ 0.12.1 з BouncyCastle 1.78.1
- SFTP: SSHJ 0.37.0 з EdDSA 0.3.0
- FTP: Apache Commons Net 3.10.0
- Хмара: Google Drive API, OneDrive (MSAL), Dropbox API з OAuth 2.0
Версія збірки
Формат: Y.YM.MDDH.Hmm (наприклад, 2.60.1102.207 для 2026/01/10 20:07)
Див. dev/CHANGELOG.md для детальної історії змін.
Contributing 🤝
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Контакти 📧
- Розробник: sza@ukr.net
- Сайт: https://serzhyale.github.io/FastMediaSorter_mob_v2/
- GitHub Issues: https://github.com/SerZhyAle/FastMediaSorter_mob_v2/issues
Ліцензія 📄
Юридична інформація проєкту:




