bear4f/netshape-manager — explained in plain English
Analysis updated 2026-05-18
Tune a Linux relay server's network settings to reduce buffering on Emby or Jellyfin streams over long distance links.
Cap each viewer's connection speed below their home bandwidth to avoid retransmission storms on international routes.
Limit a VPS's total outgoing traffic to its port speed so multiple viewers don't overload the connection.
Generate an Nginx configuration snippet that removes rate limits specifically for Emby traffic.
| bear4f/netshape-manager | aithink001/codex-dream-skin-themes | baiyuetribe/codes | |
|---|---|---|---|
| Stars | 18 | 18 | 18 |
| Language | Shell | Shell | Shell |
| Last pushed | — | — | 2020-02-21 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | easy | easy |
| Complexity | 3/5 | 2/5 | 1/5 |
| Audience | ops devops | general | ops devops |
Figures from each repo's GitHub metadata at analysis time.
Requires root/sudo on a systemd Linux VPS with bash, ip, tc, and sysctl available.
NetShape Manager is a command line tool for Linux servers, aimed at people who run a relay or proxy server, often in front of media servers like Emby or Jellyfin, over long distance internet connections with high latency. It tunes the server's networking settings automatically so that video streams have fewer stutters and dropped connections. After installing it with a single script, you run the netshape command to open an interactive menu. The tool detects your server's CPU, memory, network interface, kernel version, and whether it supports a congestion control method called BBR, then suggests safe TCP settings based on that hardware and on the rough latency between your server and your location. Its core idea is two layers of speed limiting. Each individual streaming connection is capped just under the home internet speed of the person watching, for example 430 or 450 megabits for a 500 megabit connection, so a single stream cannot overload the international link and cause a flood of retransmissions. Separately, the whole server's total outgoing traffic is capped according to the VPS provider's port speed, so the physical connection itself is never overwhelmed. This lets several people on different home connections each get their full speed at once without interfering with each other. If the server also runs Nginx as a reverse proxy for Emby, the tool can generate a configuration snippet that removes Nginx's own rate limits for Emby traffic, and can check the existing configuration for rate limiting settings that might be causing slowdowns. The tool includes commands to check status, diagnose problems, adjust settings without reinstalling, temporarily turn off the rate limits, and fully uninstall itself, restoring the previous network queue settings. It also includes a small self-test script that does not touch the system. It works only on Linux systems using systemd, needs root access, and depends on common tools like bash, ip, tc, and sysctl. It is released under the MIT license.
A command line tool that auto-tunes Linux server networking to reduce buffering and dropped connections for media relays like Emby over high-latency links.
Mainly Shell. The stack also includes Shell, Linux, sysctl.
MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.