Skip to main content

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 — quit
  • m — mute/unmute chime playback
  • c — one-shot threshold calibration: set threshold to current level + 6 dB
  • t — 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

  1. Join a call with your normal headphones/microphone setup.
  2. Speak at a comfortable normal volume.
  3. Press c to place the threshold slightly above that level.
    • c is not a mode; it immediately updates the Threshold slider and saves it.
    • After calibration, arrow keys adjust the Threshold slider for fine-tuning.
  4. Leave "Immediate first chime" enabled if you want prompt feedback.
  5. Disable "Immediate first chime" if you only want alerts after sustained loudness.
  6. If the chime triggers too often, raise the threshold or increase cooldown.
  7. If it triggers too late, lower the threshold or re-enable immediate first chime.
  8. 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)

Source distribution for inside-voice 0.1.1
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)

Table of built distributions (wheels) for inside-voice 0.1.1
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page