{"id":50745627,"url":"https://github.com/roshhellwett/projectpulsewire","last_synced_at":"2026-06-10T20:30:48.937Z","repository":{"id":320507969,"uuid":"1082347123","full_name":"roshhellwett/projectpulsewire","owner":"roshhellwett","description":"ᴘᴜʟꜱᴇᴡɪʀᴇ ᴀɴᴅ ᴇᴀꜱʏᴇꜰꜰᴇᴄᴛꜱ ᴘʀᴇꜱᴇᴛꜱ ʜᴇʀᴇ ꜰᴏʀ ʟɪɴᴜx","archived":false,"fork":false,"pushed_at":"2026-05-15T15:13:28.000Z","size":11771,"stargazers_count":23,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-30T10:23:32.526Z","etag":null,"topics":["easyeffects-presets","linux-audio","pulsewire","zenithopensourceprojects"],"latest_commit_sha":null,"homepage":"https://zenithopensourceprojects.vercel.app","language":"Python","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/roshhellwett.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":"security.md","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":"2025-10-24T05:33:50.000Z","updated_at":"2026-05-15T15:13:39.000Z","dependencies_parsed_at":"2025-10-24T07:26:33.143Z","dependency_job_id":"9ccb6901-17f0-4d97-a5a9-bafd70d6e631","html_url":"https://github.com/roshhellwett/projectpulsewire","commit_stats":null,"previous_names":["roshhellwett/easyeffects-pulsewire-presets","roshhellwett/projectpulsewire"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/roshhellwett/projectpulsewire","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectpulsewire","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectpulsewire/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectpulsewire/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectpulsewire/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roshhellwett","download_url":"https://codeload.github.com/roshhellwett/projectpulsewire/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roshhellwett%2Fprojectpulsewire/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34170162,"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":["easyeffects-presets","linux-audio","pulsewire","zenithopensourceprojects"],"created_at":"2026-06-10T20:30:48.069Z","updated_at":"2026-06-10T20:30:48.928Z","avatar_url":"https://github.com/roshhellwett.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![License](https://img.shields.io/badge/License-MIT-45b7d1?style=flat-square)](LICENSE)\n[![PyPI](https://img.shields.io/badge/PyPI-3.0.1-4ecdc4?style=flat-square)](https://pypi.org/project/projectpulsewire/)\n[![Platform](https://img.shields.io/badge/Platform-Linux-FCC624?style=flat-square\u0026logo=linux)](https://github.com/roshhellwett/projectpulsewire)\n\n# PROJECT PULSEWIRE\n\nPremium EasyEffects presets for PipeWire/PulseAudio on Linux. Transform your Linux audio experience with one command!\n\n![SAMPLE](https://github.com/roshhellwett/projectpulsewire/blob/050f1eeda9d3a7bb69efa75c78cf3007e3b20ff2/sample/samplezero.png)\n\n---\n\n## 🚀 Quick Install (For Everyone)\n\n### Step 1: Install the package\n\nOpen your terminal and run:\n\n```bash\npip install projectpulsewire\n```\n\n### Step 2: Open the menu\n\n```bash\npython -m projectpulsewire start\n```\n\n### Step 3: Choose what to do!\n\n```\n 1   Browse \u0026 Preview Presets (EQ)           ← See all available audio profiles\n 2   Browse \u0026 Preview IRS (Convolution)      ← See reverb/correction files  \n 3   Install Preset(s)                       ← Install presets to EasyEffects\n 4   Install IRS(s)                          ← Install IRS files\n 5   View Installed (Presets + IRS)          ← See what you installed\n 6   Remove Preset(s)/IRS(s)                ← Uninstall\n 7   Switch Preset Source                    ← Choose between Legacy or Modern presets\n 8   Update projectpulsewire                ← Get new versions\n 9   Help \u0026 Commands                        ← Learn more\n10   IRS Guide                              ← Learn what IRS files are \u0026 how to use them\n11   Setup Audio Stack                      ← Auto-detect \u0026 install audio dependencies\n 0   Exit\n```\n\n### Step 4: Restart EasyEffects\n\nAfter installing presets, close and reopen **EasyEffects** app. Your new presets will appear in the preset manager!\n\n---\n\n## 💻 Commands for Power Users\n\n### Interactive Menu (Recommended for Beginners)\n```bash\npython -m projectpulsewire start\n```\n\n### List All Presets\n```bash\npython -m projectpulsewire list\n```\n\n### List All IRS Files  \n```bash\npython -m projectpulsewire list-irs\n```\n\n### Install a Specific Preset\n```bash\npython -m projectpulsewire install \"Bass - Punchy Everyday\"\npython -m projectpulsewire install \"Brand - Harman Reference\"\npython -m projectpulsewire install \"Voice - Dialogue Focus\"\n```\n\n### Install an IRS File\n```bash\npython -m projectpulsewire install-irs \"BassWaves\"\npython -m projectpulsewire install-irs \"Dolby Headphone\"\n```\n\n### View Installed Items\n```bash\npython -m projectpulsewire installed\n```\n\n### Remove a Preset\n```bash\npython -m projectpulsewire remove \"Bass - Punchy Everyday\"\n```\n\n### Setup Audio Stack (Auto-Install Dependencies)\n```bash\npython -m projectpulsewire setup\n```\n\n### IRS Guide (What are IRS files?)\n```bash\npython -m projectpulsewire irs-guide\n```\n\n### Update to Latest Version\n```bash\npython -m projectpulsewire update\n```\n\n### Automatic Update Checks\n\nWhen users open the interactive app, `projectpulsewire` now checks PyPI automatically for new releases once every 24 hours.\n\n- Set `PROJECTPULSEWIRE_DISABLE_AUTO_UPDATE=1` to disable startup checks\n- Set `PROJECTPULSEWIRE_AUTO_UPDATE=1` to auto-install new releases without prompting\n\n### Get Help\n```bash\npython -m projectpulsewire --help\npython -m projectpulsewire version\n```\n\n---\n\n## 📋 System Requirements\n\n| Requirement | Details |\n|-------------|---------|\n| OS | Linux (Ubuntu, Fedora, Arch, etc.) |\n| Python | 3.10 or higher |\n| Audio Server | PipeWire (recommended) or PulseAudio |\n| Required App | [EasyEffects](https://github.com/wwmm/easyeffects) |\n\n### How to Install EasyEffects\n\n**Ubuntu/Debian:**\n```bash\nsudo apt install easyeffects\n```\n\n**Fedora:**\n```bash\nsudo dnf install easyeffects\n```\n\n**Arch Linux:**\n```bash\nsudo pacman -S easyeffects\n```\n\n**Or use the built-in auto-installer:**\n```bash\npython -m projectpulsewire setup\n```\n\n---\n\n## 🔧 Audio Stack Auto-Setup (NEW in v2.0)\n\nProjectPulsewire can automatically detect and install all essential audio packages for your Linux distribution:\n\n| Package | Purpose | Priority |\n|---------|---------|----------|\n| `pipewire` | Modern audio server | Critical |\n| `pipewire-pulse` | PulseAudio compatibility | Critical |\n| `pipewire-alsa` | ALSA compatibility | Critical |\n| `wireplumber` | Session manager | Critical |\n| `easyeffects` | Audio effects processor | Critical |\n| `lsp-plugins` | Audio plugins (EQ, compressor) | Critical |\n| `calf-plugins` | Audio plugins (reverb, etc.) | Recommended |\n| `zam-plugins` | Maximizer and utilities | Recommended |\n| `mda-lv2` | Classic LV2 plugins | Recommended |\n\nSupports: **Ubuntu/Debian**, **Fedora**, **Arch/Manjaro**, **openSUSE**, and **Flatpak**.\n\n---\n\n## 🎵 What's Included?\n\n### 47 Curated EQ Presets\n\nThe preset pack is now organized around clear sound families instead of random names, so users can predict the result before installing anything.\n\nAll presets use restrained signal chains built from **compressor**, **equalizer**, **bass enhancer**, **bass loudness**, **maximizer**, and **limiter** blocks where appropriate.\n\n**Bass (10 presets)**\n- Bass - Punchy Everyday\n- Bass - Deep Sub Lift\n- Bass - Warm Consumer\n- Bass - Tight Kick\n- Bass - Club V-Shape\n- Bass - Clean Bass Lift\n- Bass - Bass + Clarity\n- Bass - Bass + Loudness\n- Bass - Late Night Bass\n- Bass - Speaker Rescue\n\n**Genre (14 presets)**\n- Genre - EDM Festival\n- Genre - EDM Smooth\n- Genre - Rock Arena\n- Genre - Rock Classic\n- Genre - Classical Wide\n- Genre - Classical Warm\n- Genre - Lo-Fi Soft\n- Genre - Lo-Fi Air\n- Genre - Indie Presence\n- Genre - Indie Warm\n- Genre - K-Pop Sparkle\n- Genre - K-Pop Impact\n- Genre - Hi-Fi Reference\n- Genre - Hi-Fi Rich\n\n**Voice (8 presets)**\n- Voice - Dialogue Focus\n- Voice - Dialogue Night\n- Voice - Podcast Clear\n- Voice - Vocal Warmth\n- Voice - Gaming Footsteps\n- Voice - Gaming Immersion\n- Voice - Video Balanced\n- Voice - Live Stage\n\n**Brand (8 presets)**\n- Brand - Bose Warm\n- Brand - Bose Smooth Bass\n- Brand - JBL Pure Bass\n- Brand - JBL Party V\n- Brand - Harman Reference\n- Brand - Harman Kardon Lounge\n- Brand - Sony Excited\n- Brand - Sony Bright\n\n**Dynamics (7 presets)**\n- Dynamics - Loudness Light\n- Dynamics - Loudness Deep\n- Dynamics - Auto Gain Soft\n- Dynamics - Auto Gain Punch\n- Dynamics - Crystal Detail\n- Dynamics - Late Night\n- Dynamics - Soft Volume Lift\n\nBrand presets are **brand-inspired voicings**, not official Bose, JBL, Harman, Harman Kardon, or Sony factory profiles.\n\n### 404 IRS Files\n- Dolby Surround profiles\n- DFX audio enhancements\n- Creative X-Fi profiles\n- Bass enhancement\n- Room correction\n- Headphone virtualization\n\n---\n\n## 🎓 IRS Files — What Are They?\n\n**IRS (Impulse Response)** files capture the sonic signature of a real acoustic space or audio device. When loaded into EasyEffects' **Convolver** plugin, they shape your audio to sound like it's being played through that space/device.\n\n### How to Use IRS Files\n\n1. Install an IRS file using the interactive menu (option 4)\n2. Open **EasyEffects** → **Output Effects**\n3. Click **Add Effect** → Select **Convolver**\n4. In Convolver settings, click the **import/file icon**\n5. Browse to your IRS directory and select the `.irs` file\n6. **Important:** Add a **Limiter** after the Convolver to prevent clipping\n\n### IRS Categories\n| Category | Best For |\n|----------|----------|\n| Bass | Adding deep low-end to weak speakers |\n| Dolby | Surround sound on stereo headphones |\n| DFX | General audio enhancement \u0026 clarity |\n| Creative | Gaming 3D audio \u0026 spatial sound |\n\n---\n\n## 🔧 Where Do Files Go?\n\n| Type | Native Location | Flatpak Location |\n|------|-----------------|-------------------|\n| JSON Presets | `~/.config/easyeffects/output/` | `~/.var/app/com.github.wwmm.easyeffects/config/easyeffects/output/` |\n| IRS Files | `~/.config/easyeffects/irs/` | `~/.var/app/com.github.wwmm.easyeffects/config/easyeffects/irs/` |\n\n*Note: `~` means your home folder (e.g., `/home/username`)*\n\n---\n\n## 🆘 Troubleshooting\n\n### \"Command not found\" error\nMake sure Python is in your PATH. Try:\n```bash\npython3 -m projectpulsewire start\n```\n\n### Presets not appearing\n1. Make sure you restart EasyEffects after installing\n2. Check if installed: `python -m projectpulsewire installed`\n\n### Missing audio plugins\nRun the auto-setup to install all required packages:\n```bash\npython -m projectpulsewire setup\n```\n\n### Permission denied errors\nRun terminal as admin for installation:\n```bash\nsudo pip install projectpulsewire\n```\n\n---\n\n## 🙏 Acknowledgments\n\n- [EasyEffects](https://github.com/wwmm/easyeffects) - The amazing audio equalizer\n- [PipeWire](https://pipewire.org/) - Modern audio server\n- All preset creators in the Linux audio community\n\n---\n\n© 2026 [Zenith Open Source Projects](https://zenithopensourceprojects.vercel.app/). All Rights Reserved. Zenith is a Open Source Project Idea's by @roshhellwett\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froshhellwett%2Fprojectpulsewire","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froshhellwett%2Fprojectpulsewire","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froshhellwett%2Fprojectpulsewire/lists"}