MediaStudio

Own your media. Instantly find anything.

A high-performance cross-platform desktop application for organizing images and videos, built with C++17 and Qt6.

Features

• 🖼 Fast Media Browsing - Virtualized grid/list views for smooth scrolling
• 🏷 Tagging & Metadata - Edit titles, descriptions, ratings, and tags
• 🔍 Instant Search - Filter by filename, type, rating, or date
• 📁 Multi-folder Libraries - Organize media from multiple locations
• 📂 Collections & Smart Albums - Create custom collections with auto-filters
• 🔄 Duplicate Detection - Find duplicate files using content hashing
• 🎬 Video Preview - Built-in video player with playback controls
• 🖼️ Slideshow Mode - Fullscreen presentation with keyboard navigation
• 📴 Fully Offline - No cloud, no login, no tracking
• ⚡ Native Performance - Built with C++ for speed
• 🌙 Dark Mode - Beautiful dark theme included

Screenshots

Coming soon

Requirements

• Qt 6.5+ (Widgets, Sql, Multimedia, MultimediaWidgets, Concurrent)
• CMake 3.21+
• C++17 compiler (MinGW 13+, MSVC 2019+, GCC 10+, Clang 12+)
• FFmpeg (optional, for video thumbnails)
• ExifTool (optional, for advanced metadata)

Building

Windows (with Qt MinGW)

# Set environment (adjust paths to your Qt installation)
$env:Path = "C:\Qt\Tools\mingw1310_64\bin;" + $env:Path

# Configure
cmake -S . -B build -G "MinGW Makefiles" -DCMAKE_PREFIX_PATH="C:/Qt/6.10.1/mingw_64"

# Build
cmake --build build -j4

# Run (ensure Qt DLLs are in PATH)
$env:Path = "C:\Qt\6.10.1\mingw_64\bin;" + $env:Path
.\build\MediaStudio.exe

Windows (with MSVC)

# Configure (use Developer Command Prompt)
cmake -S . -B build -DCMAKE_PREFIX_PATH="C:/Qt/6.10.1/msvc2022_64"

# Build
cmake --build build --config Release

# Run
.\build\Release\MediaStudio.exe

macOS

# Configure
cmake -S . -B build -DCMAKE_PREFIX_PATH="/opt/homebrew/opt/qt@6"

# Build
cmake --build build

# Run
./build/MediaStudio.app/Contents/MacOS/MediaStudio

Linux

# Install dependencies (Ubuntu/Debian)
sudo apt install qt6-base-dev qt6-multimedia-dev cmake build-essential ffmpeg libexif-dev

# Configure
cmake -S . -B build

# Build
cmake --build build

# Run
./build/MediaStudio

Project Structure

MediaStudio/
├── src/
│   ├── main.cpp            # Application entry point
│   ├── core/               # Database, scanning, thumbnails, metadata
│   │   ├── Database.h/cpp
│   │   ├── MediaScanner.h/cpp
│   │   ├── ThumbnailGenerator.h/cpp
│   │   ├── MetadataService.h/cpp
│   │   ├── Settings.h/cpp
│   │   └── DuplicateFinder.h/cpp
│   ├── models/             # Data models
│   │   ├── MediaItem.h/cpp
│   │   ├── Tag.h/cpp
│   │   ├── Collection.h/cpp
│   │   └── *Model.h/cpp    # Qt models for views
│   ├── ui/                 # UI components
│   │   ├── MainWindow.h/cpp
│   │   ├── MediaGrid.h/cpp
│   │   ├── MediaList.h/cpp
│   │   ├── PreviewPanel.h/cpp
│   │   ├── EditorPanel.h/cpp
│   │   ├── SearchPanel.h/cpp
│   │   ├── CollectionPanel.h/cpp
│   │   ├── SlideshowWindow.h/cpp
│   │   └── DuplicatesDialog.h/cpp
│   └── utils/              # Utilities
│       ├── FileUtils.h/cpp
│       └── ImageUtils.h/cpp
├── resources/
│   ├── MediaStudio.qrc
│   └── styles/dark.qss
├── CMakeLists.txt
├── README.md
└── LICENSE

Usage

1. Add Library Folder: File → Add Folder (Ctrl+O)
2. Browse Media: Grid view (Ctrl+1) or List view (Ctrl+2)
3. Search: Use search panel or press Ctrl+F
4. Edit Metadata: Select item and use the Editor panel
5. Slideshow: Press F5 for fullscreen presentation
6. Find Duplicates: Tools → Find Duplicates
7. Collections: Use the Collections panel for smart albums

Keyboard Shortcuts

Shortcut	Action
Ctrl+O	Add folder
Ctrl+F	Focus search
Ctrl+1	Grid view
Ctrl+2	List view
Ctrl+A	Select all
Delete	Remove selected
F5	Start slideshow
F11	Fullscreen
Ctrl++	Zoom in
Ctrl+-	Zoom out

Slideshow Controls

Key	Action
Space	Pause/Resume
→ / ↓	Next image
← / ↑	Previous image
Escape	Exit slideshow

Tech Stack

• Language: C++17
• UI Framework: Qt 6 (Widgets, Multimedia)
• Database: SQLite (via Qt SQL)
• Metadata: ExifTool (CLI integration)
• Thumbnails: FFmpeg (CLI) + Qt Image
• Build: CMake 3.21+

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Subham Karande

---

Made with ❤️ and C++