LeoVasanko
e6eadb2ecd
uvicorn's reloader is unusable on Windows for this app: it restarts the server child via CTRL_C_EVENT, which is never delivered to a plain spawn child (no console process group of its own), so the child kept running old code and the reloader blocked in process.join() after the first reload — the scanner included. And when a child does restart, uvicorn hands it parent-bound sockets that ProactorEventLoop cannot register with IOCP (WinError 87 on accept), while the selector loop would break asyncio subprocesses (ffmpeg/ffprobe showreel generation). In dev mode on Windows, mediahive now runs a small supervisor instead: it watches the package with watchfiles and respawns a fresh child process (which binds its own sockets) on every change, and terminates the child on Ctrl-C. POSIX keeps uvicorn's native reload. Shutdown: RootScanner.stop() no longer does a final best-effort state save — those to_thread writes ran on the asyncio default executor, whose non-daemon threads blocked interpreter exit, so log lines appeared after the shell prompt returned. All scanner state is already persisted after each completed scan and when the showreel queue drains. Shutdown-time log lines (scan cancelled, showreel worker stopping) move to debug.
MediaHive
Netflix style browsing of your local media archive. Supports keyboard, mouse and gamepad navigation. Uses your favorite movie player.
Windows and Mac portable ZIP downloads
Getting Started
- Windows and macOS: Download the portable ZIP from the releases page, extract it anywhere, and run
MediaHive. - Linux and other platforms: Install UV and run directly with
uvx --from mediahive[gui] mediahive.
What It Does
- Scans your chosen media folder for all movies and series that can be found
- Produces preview video clips and downloads metadata
- Search on names and other metadata, not just titles
- Hand off playback to your preferred system player
Windows and macOS builds are currently portable-only (no installer). On first startup, the app asks for your media folder, which you can later change using the in-app folder icon.
Note that .mediahive folder is created in your media folder to hold all the metadata and preview clips, avoiding the lengthy processing that you will see on initial startup.
Controls
MediaHive is designed to work with a mouse, keyboard, or gamepad.
| Input | Controls |
|---|---|
| Mouse | Click posters, rows, search, play, and folder actions directly. |
| Keyboard | Arrow keys move focus, Enter activates the focused item, Escape goes back, and / jumps to search. |
| Gamepad | D-pad or left stick moves focus, A selects or plays, and B goes back. RB/LB browses adjacent items, and the Search bar has an OSD keyboard. Player controls during playback. |
Recommended Players
MediaHive opens files with the OS default player, but one specific player may be configured via settings. You are of course free to use any player instead.
Atoggles play and pause.Bcloses the player.Ytoggles mute.- D-pad up and down change volume.
- D-pad left and right seek during playback, or step frames while paused.
Background
This project started as a personal project that I have used for browsing my warez for some time now. It is still in early development, but I have just now made it public for a wider audience.