inside-voice
inside-voice is a terminal app that helps you keep your speaking volume down
while you are on Zoom, Google Meet, or other calls. It watches your microphone
level and plays a short local chime when your voice crosses above an adjustable
dB threshold, or after it stays above the threshold for a configurable duration.
The app is Linux-first and built with cross-platform pieces
(sounddevice/PortAudio + Textual), so macOS and Windows should be achievable
even though Linux is the primary target.
Features
- Live microphone level meter in dBFS
- Textual TUI with mouse/keyboard-adjustable sliders
- Sliders for threshold, repeat sustain duration, cooldown, and chime volume
- Configurable first chime behavior: immediate crossing or sustained loudness
- Generated two-tone chime; no bundled audio asset required
- Mute toggle and quick calibration action
- Settings saved under your platform config directory
- Audio input device listing and selection
Requirements
- Python 3.14+
uv- PortAudio runtime libraries
On Debian/Ubuntu-style Linux systems, PortAudio is typically available with:
sudo apt install libportaudio2 portaudio19-dev
Package names vary by distribution.
Install and run
From PyPI:
uv tool install inside-voice
inside-voice
From source:
git clone https://github.com/feoh/inside-voice.git
cd inside-voice
uv sync
uv run inside-voice
List input devices:
uv run inside-voice --list-devices
Choose a device by index or name substring:
uv run inside-voice --input-device 3
uv run inside-voice --input-device "USB Headset"
Start with a threshold override:
uv run inside-voice --threshold -28
Controls
q— quitm— mute/unmute chime playbackc— one-shot threshold calibration: set threshold to current level + 6 dBt— toggle first chime behavior between immediate and sustained- Arrow keys — adjust the focused slider; after
c, Threshold gets focus - Page Up/Page Down — adjust focused slider in larger steps
- Home/End — move focused slider to minimum/maximum
- Mouse click/drag — set slider values
Tuning tips
- Join a call with your normal headphones/microphone setup.
- Speak at a comfortable normal volume.
- Press
cto place the threshold slightly above that level.cis not a mode; it immediately updates the Threshold slider and saves it.- After calibration, arrow keys adjust the Threshold slider for fine-tuning.
- Leave "Immediate first chime" enabled if you want prompt feedback.
- Disable "Immediate first chime" if you only want alerts after sustained loudness.
- If the chime triggers too often, raise the threshold or increase cooldown.
- If it triggers too late, lower the threshold or re-enable immediate first chime.
- Increase repeat sustain if repeated chimes are annoying while staying loud.
The meter uses dBFS, where 0 dBFS is the loudest possible digital input and
quieter sounds are negative numbers. Typical microphone speech levels often land
somewhere between -45 and -15 dBFS, depending on gain and hardware.
Configuration
Settings are saved automatically to your platform config directory, for example:
- Linux:
~/.config/inside-voice/settings.json - macOS:
~/Library/Application Support/inside-voice/settings.json - Windows:
%LOCALAPPDATA%\\inside-voice\\settings.json
Development
uv sync
uv run ruff check .
uv run mypy src tests
uv run pytest
License
MIT
Metadata
Release files for inside-voice 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| inside_voice-0.1.1.tar.gz | 9.6 kB | With provenance | Details for inside_voice-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| inside_voice-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for inside_voice-0.1.1-py3-none-any.whl |
Total release size: 21.9 kB
Release files / inside_voice-0.1.1.tar.gz
| Download URL | inside_voice-0.1.1.tar.gz |
|---|---|
| Size | 9.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
37e83a883794ae822f1a508029c6c021ae8a7988b8d4a6eed17270946d1449ac
|
|
BLAKE2b-256 checksum How to use checksums |
a647334475309a1ad0e788b222ed04976fe336acc8269782cf7245657fa0ff53
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 30, 2026.
Transparency logRelease files / inside_voice-0.1.1-py3-none-any.whl
| Download URL | inside_voice-0.1.1-py3-none-any.whl |
|---|---|
| Size | 12.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1dfe0a9ddf2fff319eca23a15d3e07bde315fb4123329256271fd041b00b66a7
|
|
BLAKE2b-256 checksum How to use checksums |
d652d814fd35d1531aa2ac8a43575f5fbd87f3912e474e75956b9b36f1540ad2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 30, 2026.
Transparency logSecurity for inside-voice 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for inside_voice-0.1.1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 30, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.