# mef1sh/mediarift architecture

> Architecture diagram of the GitHub repository mef1sh/mediarift, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mef1sh/mediarift
- Repository: https://github.com/mef1sh/mediarift

## Overview

MediaRift is a client-side Minecraft mod that embeds a browser so players can use music, video, and live-stream sites without leaving the game. The main workflow is opening the in-game panel, browsing or playing a site, and controlling it with on-screen controls or hotkeys; commands also open sites and manage live streams. Live streams follow a separate documented path through streamlink, ffmpeg, a localhost server, and the player. The supplied tree contains no source files, so repository paths are unavailable; relationships below are based on README statements only.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["In-game interface"]
  node_panel["Browser panel"]
  node_overlay["Window placement"]
  node_media_controls["Media controls"]
  node_commands["Chat commands"]
end

subgraph group_browser["Browser playback"]
  node_browser["Embedded browser"]
  node_browser_library["Rinku browser library"]
  node_media_sites["Media sites"]
end

subgraph group_live["Live stream conversion"]
  node_streamlink["streamlink"]
  node_ffmpeg["ffmpeg"]
  node_local_server["Local stream server"]
  node_live_player["Live stream player"]
  node_live_sites["Live-stream services"]
end

subgraph group_preferences["Controls and settings"]
  node_hotkeys["Hotkeys"]
  node_settings["Settings"]
  node_config[("Saved configuration")]
end

node_player(("Minecraft player"))

node_player -->|"opens"| node_panel
node_player -->|"uses"| node_hotkeys
node_player -->|"enters"| node_commands
node_panel -->|"shows"| node_browser
node_panel -->|"positions"| node_overlay
node_media_controls -->|"controls playback"| node_browser
node_browser -->|"uses"| node_browser_library
node_browser -->|"opens"| node_media_sites
node_commands -->|"opens sites"| node_browser
node_commands -->|"starts streams"| node_streamlink
node_hotkeys -->|"toggles"| node_panel
node_hotkeys -->|"controls"| node_media_controls
node_settings -->|"saves"| node_config
node_settings -->|"configures"| node_overlay
node_settings -->|"sets stream options"| node_live_player
node_streamlink -->|"fetches streams"| node_live_sites
node_streamlink -->|"pipes stream"| node_ffmpeg
node_ffmpeg -->|"serves conversion"| node_local_server
node_local_server -->|"feeds stream"| node_live_player

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_panel,node_overlay,node_media_controls,node_commands toneBlue
class node_browser,node_browser_library,node_media_sites toneAmber
class node_streamlink,node_ffmpeg,node_local_server,node_live_player,node_live_sites toneMint
class node_hotkeys,node_settings,node_config toneRose
class node_player toneIndigo
```

## Components

### In-game interface

- **Browser panel**
- **Window placement**
- **Media controls**
- **Chat commands**

### Browser playback

- **Embedded browser**
- **Rinku browser library**
- **Media sites**

### Live stream conversion

- **streamlink**
- **ffmpeg**
- **Local stream server**
- **Live stream player**
- **Live-stream services**

### Controls and settings

- **Hotkeys**
- **Settings**
- **Saved configuration**

### Other components

- **Minecraft player**

## Connections

- Minecraft player → Browser panel: opens (evidence: `README.txt`)
- Minecraft player → Hotkeys: uses (evidence: `README.txt`)
- Minecraft player → Chat commands: enters (evidence: `README.txt`)
- Browser panel → Embedded browser: shows (evidence: `README.txt`)
- Browser panel → Window placement: positions (evidence: `README.txt`)
- Media controls → Embedded browser: controls playback (evidence: `README.txt`)
- Embedded browser → Rinku browser library: uses (evidence: `README.txt`)
- Embedded browser → Media sites: opens (evidence: `README.txt`)
- Chat commands → Embedded browser: opens sites (evidence: `README.txt`)
- Chat commands → streamlink: starts streams (evidence: `README.txt`)
- Hotkeys → Browser panel: toggles (evidence: `README.txt`)
- Hotkeys → Media controls: controls (evidence: `README.txt`)
- Settings → Saved configuration: saves (evidence: `README.txt`)
- Settings → Window placement: configures (evidence: `README.txt`)
- Settings → Live stream player: sets stream options (evidence: `README.txt`)
- streamlink → Live-stream services: fetches streams (evidence: `README.txt`)
- streamlink → ffmpeg: pipes stream (evidence: `README.txt`)
- ffmpeg → Local stream server: serves conversion (evidence: `README.txt`)
- Local stream server → Live stream player: feeds stream (evidence: `README.txt`)
