git404hub

what is netshape-manager fr?

bear4f/netshape-manager — explained in plain English

Analysis updated 2026-05-18

18ShellAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

tl;dr

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.

vibe map

mindmap
  root((NetShape Manager))
    What it does
      Tune TCP settings
      Rate limit connections
      Reduce retransmissions
    Tech stack
      Bash
      tc and HTB
      sysctl
    Use cases
      Media relay servers
      Emby proxy tuning
      High latency links
    Audience
      VPS operators
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Tune a Linux relay server's network settings to reduce buffering on Emby or Jellyfin streams over long distance links.

VIBE 2

Cap each viewer's connection speed below their home bandwidth to avoid retransmission storms on international routes.

VIBE 3

Limit a VPS's total outgoing traffic to its port speed so multiple viewers don't overload the connection.

VIBE 4

Generate an Nginx configuration snippet that removes rate limits specifically for Emby traffic.

what's the stack?

ShellLinuxsysctltcsystemd

how it stacks up fr

bear4f/netshape-manageraithink001/codex-dream-skin-themesbaiyuetribe/codes
Stars181818
LanguageShellShellShell
Last pushed2020-02-21
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity3/52/51/5
Audienceops devopsgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires root/sudo on a systemd Linux VPS with bash, ip, tc, and sysctl available.

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Help me choose the right --rate and --total values for netshape-manager given my VPS port speed and viewers' home internet speeds.
prompt 2
Explain what the HTB and fq maxrate settings that netshape-manager configures actually do to my server's network queue.
prompt 3
Walk me through installing netshape-manager on my VPS and running the non-interactive setup with my RTT to home.
prompt 4
Help me use netshape diagnose and nginx-audit to figure out why my Emby stream through this relay keeps stuttering.

Frequently asked questions

what is netshape-manager fr?

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.

What language is netshape-manager written in?

Mainly Shell. The stack also includes Shell, Linux, sysctl.

What license does netshape-manager use?

MIT license: use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is netshape-manager to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is netshape-manager for?

Mainly ops devops.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.