https://github.com/rabfulton/reelvault
A linux GTK3 local movie database/browser application
https://github.com/rabfulton/reelvault
bloat-free film-database film-scanner gtk3 linux-desktop media-player native-apps suckless tmdb tmdb-api
Last synced: 4 months ago
JSON representation
A linux GTK3 local movie database/browser application
- Host: GitHub
- URL: https://github.com/rabfulton/reelvault
- Owner: rabfulton
- Created: 2026-02-02T19:27:53.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-02-07T19:54:32.000Z (5 months ago)
- Last Synced: 2026-02-09T05:33:52.766Z (5 months ago)
- Topics: bloat-free, film-database, film-scanner, gtk3, linux-desktop, media-player, native-apps, suckless, tmdb, tmdb-api
- Language: C
- Homepage:
- Size: 2.08 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ReelVault
A native GTK3 application for browsing and launching your local film collection. Requires a TMDB API key to fetch film details.
## Features
- **Poster Grid:** Browse your film collection with cover art scraped from TMDB
- **Metadata:** View cast, crew, ratings, plot summaries, and more
- **Filtering:** Filter by genre and year
- **Sorting:** Sort by title, year, rating, date added
- **External Player:** Launch films in your preferred video player
- **Manual Matching:** Fix incorrect matches or identify unrecognized films
## Installation
### Arch Linux (AUR)
- Package: https://aur.archlinux.org/packages/reelvault
Using an AUR helper:
```bash
yay -S reelvault
```
### Debian/Ubuntu (.deb)
Download the `.deb` from GitHub Releases, then install it:
```bash
sudo apt install ./reelvault_*.deb
```
### Fedora/RHEL (.rpm)
Download the `.rpm` from GitHub Releases, then install it:
```bash
sudo dnf install ./reelvault-*.rpm
```
## Running
```bash
reelvault
```
On first run, you'll be prompted to:
1. Enter your TMDB API key (get one free at https://www.themoviedb.org/settings/api)
2. Add your film library directories
The config file is stored here: `~/.config/reelvault/config.ini`
You can also set the TMDB metadata language in **Settings** using a locale code
such as `en-US`, `es-ES`, or `fr-FR`. If left blank, ReelVault defaults to
`en-US`.
## Advanced Search
The search bar supports simple `key:value` tokens:
- `actor: Nick` or `cast:nick` (search cast/actors)
- `plot: kidnapping` (search plot/overview text)
- `title: dune` (search title explicitly)
You can combine tokens and plain text. Plain text searches the title.
Examples:
```text
actor:"Jason Momoa" dune
plot:"time travel"
title: alien
```
## Building From Source
### Dependencies
- GTK 3.0
- SQLite 3
- libcurl
- json-c
- libjpeg-turbo (libturbojpeg)
#### Arch Linux
```bash
sudo pacman -S base-devel gtk3 sqlite curl json-c libjpeg-turbo
```
#### Debian/Ubuntu
```bash
sudo apt install build-essential pkg-config libgtk-3-dev libsqlite3-dev libcurl4-openssl-dev libjson-c-dev libturbojpeg0-dev
```
### Build
```bash
make
```
### Run
```bash
./reelvault
```
## License
MIT
## Other Useful Projects
- A lightweight speech to text implementation [Auriscribe](https://github.com/rabfulton/Auriscribe)
- A full featured AI application [ChatGTK](https://github.com/rabfulton/ChatGTK)
- A Markdown notes application for your system tray [TrayMD](https://github.com/rabfulton/TrayMD)
- Try my AI panel plugin for XFCE [XFCE Ask](https://github.com/rabfulton/xfce-ask)