MediaStream Plugin - User Guide

\## 🎬 how to play videos in rutorrent the mediastream plugin lets you watch video files directly in your browser without downloading them first! \ \## 📋 quick start (3 easy steps) \### step 1 find your video 1 click the filemanager button in rutorrent's top toolbar2 browse through your folders to find a video file3 look for common video formats ` mp4`, ` mkv`, ` avi`, ` webm`, etc \### step 2 play the video right click on any video file and select "view video" from the menu !\[context menu example]\( https //via placeholder com/400x200/4caf50/white?text=right click+%e2%86%92+view+video ) \### step 3 enjoy! the video player will open in a popup window click the play button ▶️ to start watching use the controls at the bottom to adjust volume, seek, or go fullscreen \ \## 🎮 player controls \### basic controls | control | what it does || | || play/pause ▶️⏸️ | start or pause the video || volume 🔊 | adjust sound level (or mute) || seek bar ━━━━●━━━━ | jump to any part of the video || fullscreen ⛶ | watch in fullscreen mode || close ✖️ | close the player window | \### keyboard shortcuts spacebar play/pause f fullscreen toggle m mute/unmute arrow keys seek forward/backward escape exit fullscreen \ \## ⚙️ customizing your experience \### opening settings 1 go to rutorrent settings (gear icon ⚙️ in top toolbar)2 find "mediastream" in the left sidebar3 adjust your preferences! \### available settings \#### 🎨 player appearance player width how wide the video window is (default 800px) player height how tall the video window is (default 600px) \#### 📹 video quality default quality choose your preferred quality 🟢 auto let the browser decide (recommended) 🔵 720p hd quality 🔴 1080p full hd quality ⚫ original no transcoding (highest quality) \#### 🔊 audio default volume set your preferred volume level (0 100%) muted by default start videos muted (useful in offices!) \#### 🎞️ format support enable/disable formats choose which video formats you want to play three categories ✅ recommended works great in all browsers (mp4, webm, ogg) ⚠️ may work requires proper codecs (mkv, avi, mov, etc ) 🔶 limited support older/specialized formats (flv, wmv, etc ) \ \## 📂 supported file formats \### ✅ always works (recommended) these formats play perfectly in all modern browsers mp4 ( mp4, m4v) most common format webm ( webm) modern web format ogg ( ogv, ogg) open source format \### ⚠️ usually works (may require codecs) these formats work if your browser supports the video codec inside mkv ( mkv) matroska container avi ( avi) common windows format mov ( mov) quicktime format flv ( flv) flash video wmv ( wmv) windows media video mpg/mpeg ( mpg, mpeg) mpeg format 3gp ( 3gp) mobile video format and many more! \### 💡 pro tip if a video won't play, it's usually a codec issue, not a format issue try converting it to mp4 (h 264 codec) for best compatibility \ \## 🔍 troubleshooting \### "video won't play" or shows black screen cause your browser doesn't support the video codec solutions 1 try a different browser (chrome/edge usually have best support)2 convert the video to mp4 format with h 264 codec3 check if the video file is corrupted by downloading it first \### "view video" option doesn't appear cause file isn't recognized as a video solutions 1 check if the file extension is enabled in settings2 make sure the file actually is a video (not mislabeled)3 reload rutorrent page (ctrl+f5) \### player window is too small/large solution go to settings → mediastream and adjust player width/height \### video is choppy or buffering causes network speed, server load, or video bitrate solutions 1 lower the quality setting in settings2 wait for more of the file to download3 try during off peak hours if server is busy \### no sound solutions 1 check if browser tab is muted (look for 🔇 icon on tab)2 check video player volume control (bottom left)3 unmute in settings if "muted by default" is enabled4 some videos don't have audio tracks download to verify \ \## 🎯 best practices \### for best performance 1 ✅ use mp4 files with h 264 codec when possible2 ✅ keep player dimensions reasonable (don't go 4k on a 1080p monitor)3 ✅ use auto quality setting unless you have specific needs4 ✅ close player when done to free up server resources \### for privacy 🔒 remember video streaming creates temporary logs on the server 🔒 respect your server's bandwidth and storage limits 🔒 don't share your streaming links they're tied to your session \### for multi user setups 👥 each user has their own settings (they don't affect others) 👥 settings are saved per user automatically 👥 you can reset to defaults anytime in settings \ \## 📖 quick reference \### common workflows \#### "i want to preview a video before downloading" 1 open filemanager2 right click video → view video3 watch enough to decide4 close player and continue/stop download \#### "i want to watch a completed download" 1 open filemanager2 navigate to completed downloads3 right click video → view video4 enjoy in fullscreen! \#### "i want to check video quality" 1 open filemanager2 right click video → view video3 click fullscreen ⛶4 assess quality visually \#### "i want to show someone a clip" 1 open filemanager2 right click video → view video3 use seek bar to find the moment4 share screen (player only works for you, not shareable links) \ \## 🆘 still need help? \### check the logs if something isn't working, check the rutorrent log (bottom panel) look for \[mediastream] messages note any error messages share these with your administrator \### contact your administrator your server admin can check server side logs for streaming errors verify file permissions are correct install missing codec support adjust streaming buffer sizes for performance \### report issues when reporting problems, include video file format and size browser name and version error message from rutorrent log what you expected vs what happened \ \## 🌟 pro tips & tricks 1\ multi monitor setup drag player to second monitor and go fullscreen for dedicated viewing2 quick preview double click to play, spacebar to pause at interesting frames3 format testing try different browsers if playback fails firefox vs chrome vs edge can differ4 bandwidth management lower quality settings during peak hours5 seek before loading use seek bar to jump ahead player will start buffering from that point \ \## 📝 version information plugin version 2 0 0 last updated november 2025 author evoseedbox team \ \ \## 🙏 enjoy your videos! happy streaming! remember to thank your server administrator for setting this up 🎬🍿 \ this guide is for mediastream plugin v2 0 0 and above if you're using an older version, some features may not be available