Metadata-Version: 2.4
Name: mediahive
Version: 0.4.3
Summary: MediaHive - Media scanning, indexing, and Netflix-style streaming
Project-URL: Repository, https://git.zi.fi/LeoVasanko/mediahive
Requires-Python: >=3.14
Requires-Dist: aiofiles>=25.1.0
Requires-Dist: aiopathlib>=0.6.0
Requires-Dist: bencodepy>=0.9.5
Requires-Dist: fastapi-vue>=0.5.2
Requires-Dist: fastapi[standard]>=0.128.0
Requires-Dist: httpx[http2]>=0.28.1
Requires-Dist: msgspec>=0.19
Requires-Dist: parse-torrent-title>=2.8.1
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: uvicorn[standard]>=0.40.0
Provides-Extra: gui
Requires-Dist: pyinstaller>=6.0; extra == 'gui'
Requires-Dist: pyqt5>=5.15.11; (platform_system == 'Darwin') and extra == 'gui'
Requires-Dist: pythonnet>=3.1.0rc0; (platform_system == 'Windows' and python_version >= '3.14') and extra == 'gui'
Requires-Dist: pywebview>=6.2.1; (platform_system == 'Windows') and extra == 'gui'
Requires-Dist: pywebview[qt]>=6.2.1; (platform_system != 'Windows') and extra == 'gui'
Requires-Dist: qtpy>=2.4.1; (platform_system == 'Darwin') and extra == 'gui'
Description-Content-Type: text/markdown

![MediaHive](docs/mediahive.avif)

# 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](https://git.zi.fi/LeoVasanko/mediahive/releases)**

## 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](https://docs.astral.sh/uv/getting-started/installation/) 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

- Windows: [MPC-BE](https://github.com/Aleksoid1978/MPC-BE/releases)
- macOS: [IINA](https://iina.io/)
- Linux: SMPlayer

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.

- `A` toggles play and pause.
- `B` closes the player.
- `Y` toggles 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.
