whatisgithub

What is screenstereov1.0.1?

abugarr21/screenstereov1.0.1 — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Linux utility that splits stereo audio across two monitors' speakers by left and right channel, or mirrors the same audio to both, with confirmed hardware mapping.

Mindmap

mindmap
  root((ScreenStereo))
    What it does
      Splits stereo audio across two screens
      Or mirrors audio to both
      Maps displays by hardware identity
    Modes
      Split left and right
      Mirror same audio
      Reset apply and status
    Requirements
      Ubuntu 24.04 with GNOME on X11
      PipeWire and PulseAudio compatibility
      pactl wpctl and xrandr tools
    Privacy
      No microphone recording
      No telemetry sent
      GPL-3.0-or-later license

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 build with it?

USE CASE 1

Split true left and right stereo audio across two separate monitor speakers using ScreenStereo's split mode.

USE CASE 2

Mirror the same audio to two displays at once for a presentation or dual-screen setup using mirror mode.

USE CASE 3

Run the guided first-run setup to confirm which display and audio device should be left versus right before ScreenStereo saves the mapping.

What is it built with?

PythonBashPipeWireLinux

How does it compare?

abugarr21/screenstereov1.0.10xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperresearcher

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Ubuntu 24.04 with GNOME on X11, PipeWire, and command line tools like pactl, wpctl, and xrandr.

Free to use, study, modify, and redistribute, as long as any distributed modified versions stay open under the same GPL license.

So what is it?

ScreenStereo is a Linux utility for people who have two monitors, each with its own speakers or audio output, and want to control how sound is split between them. It can either send the left channel of a stereo signal to one screen's audio output and the right channel to the other, splitting true stereo sound across two displays, or send the exact same audio to both screens as a mirrored pair. The tool works by identifying your two displays and their matching audio outputs by their hardware identity rather than by whatever connector number Linux happens to assign them at boot, since that numbering can change between reboots or when cables are unplugged. When you first set it up, it shows you which display and audio device it thinks should be left and which should be right, and it will not save that mapping until you type back an exact confirmation phrase matching what it displayed, so a mismatch cannot be applied by accident. Five operating modes are available: split for true left and right stereo across two screens, mirror to send the same audio to both, reset to remove ScreenStereo's audio routing changes, apply to reapply your saved configuration, and status to check the current setup. The tool includes an installer script that copies its files and a background indicator into your home directory, and a separate first-run setup script that walks you through picking and confirming your display and audio mapping. It was built and tested specifically on Ubuntu 24.04 with GNOME running on X11, using the PipeWire audio system and its PulseAudio compatibility layer. Running it depends on several existing Linux command line tools being present, including pactl, wpctl, and xrandr. The README states plainly that the tool does not record microphone audio, does not send any telemetry, and does not upload information about your hardware anywhere. ScreenStereo is released under the GPL-3.0-or-later license, meaning anyone can use, study, modify, and redistribute it, as long as any distributed modified versions stay open under the same license terms.

Copy-paste prompts

Prompt 1
Walk me through installing ScreenStereo on Ubuntu 24.04 and running the first-run setup.
Prompt 2
Explain the difference between ScreenStereo's split and mirror audio modes.
Prompt 3
What Linux command line tools does ScreenStereo depend on, and how do I check I have them installed?
Prompt 4
Show me how to reset ScreenStereo's audio routing back to normal using its reset mode.

Frequently asked questions

What is screenstereov1.0.1?

A Linux utility that splits stereo audio across two monitors' speakers by left and right channel, or mirrors the same audio to both, with confirmed hardware mapping.

What language is screenstereov1.0.1 written in?

Mainly Python. The stack also includes Python, Bash, PipeWire.

What license does screenstereov1.0.1 use?

Free to use, study, modify, and redistribute, as long as any distributed modified versions stay open under the same GPL license.

How hard is screenstereov1.0.1 to set up?

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

Who is screenstereov1.0.1 for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.