{"id":50731494,"url":"https://github.com/paulprogrammer/pocketlint","last_synced_at":"2026-06-10T09:01:50.758Z","repository":{"id":361020063,"uuid":"1252748862","full_name":"paulprogrammer/pocketlint","owner":"paulprogrammer","description":"PipeWire Audio Logical Y-Split Recorder and Pocket AI Uploader","archived":false,"fork":false,"pushed_at":"2026-05-28T20:58:05.000Z","size":111,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T22:21:02.925Z","etag":null,"topics":["audio","electron","loopback","pipewire","pocketai","recorder"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paulprogrammer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-28T20:41:50.000Z","updated_at":"2026-05-28T21:02:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/paulprogrammer/pocketlint","commit_stats":null,"previous_names":["paulprogrammer/pocketlint"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/paulprogrammer/pocketlint","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulprogrammer%2Fpocketlint","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulprogrammer%2Fpocketlint/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulprogrammer%2Fpocketlint/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulprogrammer%2Fpocketlint/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paulprogrammer","download_url":"https://codeload.github.com/paulprogrammer/pocketlint/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paulprogrammer%2Fpocketlint/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34144680,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","electron","loopback","pipewire","pocketai","recorder"],"created_at":"2026-06-10T09:01:49.193Z","updated_at":"2026-06-10T09:01:50.753Z","avatar_url":"https://github.com/paulprogrammer.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PocketLint\n\nPocketLint is an Electron-based desktop application for Linux that manages an audio logical Y-split using PipeWire's virtual loopback devices. It allows you to record system audio while simultaneously routing it to physical outputs (e.g., speakers or headphones). Once recorded, the app post-processes the split channels, mixing them into a single-channel mono MP3 file, and uploads the audio to HeyPocketAI via their public API for transcription and processing.\n\n## Features\n\n- **PipeWire Logical Y-Split Management**: Dynamically creates a virtual null sink (`PocketLoopback`) and loops its monitor output back to your choice of physical playback devices using PipeWire's Pulse compatibility layer.\n- **Audio Output Verification**: Includes a \"Test Output Sound\" function to generate and play a 1-second synthesized tone through the loopback device to confirm physical audio routing before recording.\n- **Background Recorder**: Captures raw system audio cleanly to temporary WAV files using native PipeWire tools (`pw-record`).\n- **Post-processing Pipeline**: Uses FFmpeg to perform an FFT noise-reduction pass (`afftdn`) on each input stream, downmixes them to mono, and executes a dual-pass loudness normalization (`loudnorm`) before encoding to MP3. If either the microphone or system stream is silent, the loudness normalization is safely skipped to preserve dynamic range.\n- **Pocket AI Upload Pipeline**: Connects with the HeyPocketAI API to request pre-signed S3 upload URLs and uploads the completed MP3 recording.\n- **Local Persistence \u0026 Retry Queue**: Stores all recordings locally in `~/.config/pocketlint` until they are successfully uploaded. Displays status indicators (`Ready to sync`, `Processing`, `Syncing...`, `Synced`, `Failed`) and allows manual retry for failed uploads.\n\n## Prerequisites\n\nEnsure the following tools are installed on your Linux system:\n- **PipeWire** (with `pipewire-pulse` compatibility)\n- **pactl** (PulseAudio client controller)\n- **pw-record** / **pw-play** (native PipeWire capture and playback tools)\n- **ffmpeg** (used for generating test tones, noise reduction, loudness normalization, and MP3 encoding)\n\nOn Fedora/RHEL:\n```bash\nsudo dnf install pipewire-utils pulseaudio-utils ffmpeg\n```\n\nOn Ubuntu/Debian:\n```bash\nsudo apt install pipewire-utils pulseaudio-utils ffmpeg\n```\n\n## Getting Started\n\n1. Clone the repository and navigate to the project directory:\n   ```bash\n   cd pocketlint\n   ```\n2. Install the Node.js dependencies:\n   ```bash\n   pnpm install\n   ```\n3. Start the application:\n   ```bash\n   pnpm start\n   ```\n\n## Meeting App Setup\n\nTo record calls and meetings successfully without creating audio feedback loops or echo:\n* **Speaker / Output**: In Zoom, Google Meet, Slack, or other meeting apps, select **`PocketLoopback`** as the speaker output.\n* **Microphone / Input**: Select your **Physical Microphone** (do not select `PocketRecordMix` to avoid echo).\n\n## Local Storage Layout\n\nThe application saves configuration, the upload queue, and audio files in the Electron application user data folder:\n- **Config file**: `~/.config/pocketlint/config.json`\n- **Metadata Database**: `~/.config/pocketlint/queue.json`\n- **Audio Files**: `~/.config/pocketlint/recordings/` (saved as `.mp3` files after post-processing)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulprogrammer%2Fpocketlint","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaulprogrammer%2Fpocketlint","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaulprogrammer%2Fpocketlint/lists"}