{"id":31074135,"url":"https://github.com/keyofblues/current-volume","last_synced_at":"2026-05-01T21:34:35.643Z","repository":{"id":312425273,"uuid":"1047451929","full_name":"KeyofBlueS/current-volume","owner":"KeyofBlueS","description":"A tiny, lightweight and fast Bash script to show your system's audio volume.","archived":false,"fork":false,"pushed_at":"2025-08-30T14:27:32.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-30T15:21:29.897Z","etag":null,"topics":["bash","bash-script","conky","linux","mangohud","overlay","pipewire","pipewire-pulseaudio","sound","steam","volume","wireplumber"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KeyofBlueS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=EFJW5YSFSLGRU"}},"created_at":"2025-08-30T13:00:31.000Z","updated_at":"2025-08-30T14:27:35.000Z","dependencies_parsed_at":"2025-08-30T15:21:31.594Z","dependency_job_id":"a4a6ad87-c1c4-412d-808e-5d3683b37225","html_url":"https://github.com/KeyofBlueS/current-volume","commit_stats":null,"previous_names":["keyofblues/current-volume"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/KeyofBlueS/current-volume","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KeyofBlueS%2Fcurrent-volume","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KeyofBlueS%2Fcurrent-volume/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KeyofBlueS%2Fcurrent-volume/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KeyofBlueS%2Fcurrent-volume/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KeyofBlueS","download_url":"https://codeload.github.com/KeyofBlueS/current-volume/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KeyofBlueS%2Fcurrent-volume/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275348511,"owners_count":25448626,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-16T02:00:10.229Z","response_time":65,"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":["bash","bash-script","conky","linux","mangohud","overlay","pipewire","pipewire-pulseaudio","sound","steam","volume","wireplumber"],"created_at":"2025-09-16T02:03:32.853Z","updated_at":"2026-05-01T21:34:35.632Z","avatar_url":"https://github.com/KeyofBlueS.png","language":"Shell","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=EFJW5YSFSLGRU","https://ko-fi.com/keyofblues"],"categories":[],"sub_categories":[],"readme":"# current-volume\n\n# Version:    0.1.1\n# Author:     KeyofBlueS\n# Repository: https://github.com/KeyofBlueS/current-volume\n# License:    GNU General Public License v3.0, https://opensource.org/licenses/GPL-3.0\n\n### ☕️ [If you like what I do, consider buying me a coffee, it really helps!](https://ko-fi.com/keyofblues) ☕️\n\n### DESCRIPTION\nA tiny, lightweight and fast Bash script to show your system's audio volume.\n\nI mainly wrote this to show the volume in MangoHud, but you can use it anywhere you like, for example in Conky.\n\n### FEATURES\n- Uses `wpctl` (PipeWire) to get the default audio sink/source volume.\n- Compatible with Steam runtime environments - automatically wraps `wpctl` command in `steam-runtime-launch-client` if SteamEnv is set.\n- Shows volume as a simple percentage, e.g., `5%`, `60%` or `150%`.\n- Adds `(MUTE)` if the audio is muted.\n\n### INSTALL\n```sh\ncurl -o /tmp/current-volume.sh 'https://raw.githubusercontent.com/KeyofBlueS/current-volume/main/current-volume.sh'\nsudo mkdir -p /opt/current-volume/\nsudo mv /tmp/current-volume.sh /opt/current-volume/\nsudo chown root:root /opt/current-volume/current-volume.sh\nsudo chmod 755 /opt/current-volume/current-volume.sh\nsudo chmod +x /opt/current-volume/current-volume.sh\nsudo ln -s /opt/current-volume/current-volume.sh /usr/local/bin/current-volume\n```\n### USAGE\n```sh\n$ current-volume\n```\n```\nOptions:\n-s, --sink      Show the default sink (e.g. speakers, headphones) volume (default).\n-m, --mic       Show the default source (e.g. microphone) volume.\n-h, --help      Show this help.\n```\n### USING WITH MangoHud\nYou can display the current volume in MangoHud by adding a custom command to your MangoHud configuration file (usually `~/.config/mangohud/MangoHud.conf`):\n```\ncustom_text=Volume\nexec=/opt/current-volume/current-volume.sh\n\ncustom_text=Mic\nexec=/opt/current-volume/current-volume.sh -m\n```\n`custom_text` is the label that will appear in the overlay.\n\n`exec` should point to the path where you saved the `current-volume.sh` script.\n\n\u003cimg width=\"478\" height=\"484\" alt=\"mangohud_volume\" src=\"https://github.com/user-attachments/assets/c8366371-ae27-4199-bff1-d4f55d260271\" /\u003e\n\nThe script will automatically detect if you're running in Steam ($SteamEnv) and display the correct volume with (MUTE) if muted.\n\nThis makes it easy to see your system volume directly in games.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeyofblues%2Fcurrent-volume","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkeyofblues%2Fcurrent-volume","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkeyofblues%2Fcurrent-volume/lists"}