{"id":50719026,"url":"https://github.com/pcs-electronics/volumio-control","last_synced_at":"2026-06-09T22:01:08.790Z","repository":{"id":349195981,"uuid":"1201286178","full_name":"pcs-electronics/volumio-control","owner":"pcs-electronics","description":"A command-line tool to control a local Volumio music player instance.","archived":false,"fork":false,"pushed_at":"2026-04-04T18:53:11.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-04T20:07:39.122Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/pcs-electronics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-04T13:21:26.000Z","updated_at":"2026-04-04T18:53:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pcs-electronics/volumio-control","commit_stats":null,"previous_names":["pcs-electronics/volumio-control"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/pcs-electronics/volumio-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pcs-electronics%2Fvolumio-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pcs-electronics%2Fvolumio-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pcs-electronics%2Fvolumio-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pcs-electronics%2Fvolumio-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pcs-electronics","download_url":"https://codeload.github.com/pcs-electronics/volumio-control/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pcs-electronics%2Fvolumio-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34127345,"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-09T02:00:06.510Z","response_time":63,"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":[],"created_at":"2026-06-09T22:01:07.873Z","updated_at":"2026-06-09T22:01:08.764Z","avatar_url":"https://github.com/pcs-electronics.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Volumio Control\n\nA command-line tool to control a local Volumio music player instance.\n\n## Features\n\n- Play music by name, playlist, album, or web radio\n- Search for files, albums, and web radios\n- Stop playback\n- Support for direct stream URLs and Volumio media URIs\n- Dry run mode for testing\n\n## Installation\n\n1. Ensure Python 3 is installed on your system.\n2. Clone or download this repository.\n3. Make the script executable: `chmod +x volumio-control.py`\n\n## Usage\n\nThe tool communicates with Volumio at `http://127.0.0.1:3000` by default. You can change this by setting the `VOLUMIO_BASE_URL` environment variable.\n\n### Commands\n\n- `python3 volumio-control.py play` - Resume playback\n- `python3 volumio-control.py play \u003cname\u003e` - Play an exact matched playlist, file, album, or web radio\n- `python3 volumio-control.py play \u003curi\u003e` - Play a direct stream URL or Volumio media URI\n- `python3 volumio-control.py queue \u003cname\u003e` - Queue an exact matched playlist, file, album, or web radio (adds to queue if playing file, stops stream and plays immediately if playing stream)\n- `python3 volumio-control.py queue \u003curi\u003e` - Queue a direct stream URL or Volumio media URI, then start playback\n- `python3 volumio-control.py show-queue` - Show the current Volumio queue\n- `python3 volumio-control.py clear-queue` - Clear the current Volumio queue\n- `python3 volumio-control.py remove-queue \u003cname|uri\u003e` - Remove item(s) from the current queue by song name or URI\n- `python3 volumio-control.py status` - Show the current playback status, including file/stream details\n- `python3 volumio-control.py stop` - Stop playback\n- `python3 volumio-control.py search \u003cquery\u003e` - Search for files, albums, and web radios\n\n\u003e Note: queueing an internet radio URL may still fail if the stream URL itself is invalid or unreachable. The script now validates stream URLs before adding them to the queue.\n\n### Environment Variables\n\n- `VOLUMIO_BASE_URL`: Base URL of the Volumio instance (default: http://127.0.0.1:3000)\n- `VOLUMIO_DRY_RUN`: Enable dry run mode (set to 1, true, yes, or on)\n\n## Examples\n\n```bash\n# Resume playback\npython3 volumio-control.py play\n\n# Play a specific song\npython3 volumio-control.py play \"Bohemian Rhapsody\"\n\n# Play a web radio stream\npython3 volumio-control.py play \"http://example.com/stream.mp3\"\n\n# Search for music\npython3 volumio-control.py search jazz\n\n# Queue a song (adds to queue if playing file, stops stream and plays if playing stream)\npython3 volumio-control.py queue \"Bohemian Rhapsody\"\n# Show the current queue\npython3 volumio-control.py show-queue\n# Remove a queued item by name or URL\npython3 volumio-control.py remove-queue \"Bohemian Rhapsody\"\n# Clear the current queue\npython3 volumio-control.py clear-queue\n# Show current playback status\npython3 volumio-control.py status\n# Stop playback\npython3 volumio-control.py stop\n```\n\n## Development\n\nThis project was built with AI coding tools.\n\n## AI Agent Integration\n\nA `SKILL.md` file is included in the `skills/volumio-control/` folder. This file provides a structured skill definition that can be used by AI agents to control Volumio playback.\n\nTo use this skill with your AI agent:\n\n1. Copy the `skills/volumio-control/SKILL.md` file to your agent's skills folder.\n2. Configure your agent to recognize the skill by placing it in the appropriate path according to your agent framework's conventions.\n3. Your agent can then:\n   - Control Volumio playback (play, stop, resume, queue)\n   - Search for web radios, albums, and files\n   - Play or queue playlists by exact name\n   - Handle direct stream URLs and Volumio media URIs\n   - Resolve ambiguous media names into candidate matches\n\nThe skill includes command categories, matching behavior, workflow guidance, and examples for all supported operations.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpcs-electronics%2Fvolumio-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpcs-electronics%2Fvolumio-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpcs-electronics%2Fvolumio-control/lists"}