{"id":16520543,"url":"https://github.com/douxxu/piwave-webgui","last_synced_at":"2025-08-05T15:16:55.976Z","repository":{"id":255557740,"uuid":"852415352","full_name":"douxxu/piwave-webgui","owner":"douxxu","description":"PiWave WebGUI is a web-based interface designed to manage and control your PiWave directly from your browser.","archived":false,"fork":false,"pushed_at":"2024-12-18T18:17:45.000Z","size":131,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-13T10:49:16.834Z","etag":null,"topics":["fm","gui","hijacking","pifmrds","piwave","radio","raspberry","rpi","web","webgui"],"latest_commit_sha":null,"homepage":"https://piwave.xyz/webgui/test","language":"HTML","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/douxxu.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}},"created_at":"2024-09-04T19:06:31.000Z","updated_at":"2025-01-12T12:17:03.000Z","dependencies_parsed_at":"2024-09-06T02:44:06.137Z","dependency_job_id":"44e8f922-ff79-4e82-9cb9-91a3151c863c","html_url":"https://github.com/douxxu/piwave-webgui","commit_stats":null,"previous_names":["douxxu/piwave-webgui"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxu%2Fpiwave-webgui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxu%2Fpiwave-webgui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxu%2Fpiwave-webgui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/douxxu%2Fpiwave-webgui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/douxxu","download_url":"https://codeload.github.com/douxxu/piwave-webgui/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241587917,"owners_count":19986627,"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","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":["fm","gui","hijacking","pifmrds","piwave","radio","raspberry","rpi","web","webgui"],"created_at":"2024-10-11T16:51:28.993Z","updated_at":"2025-03-02T23:43:11.461Z","avatar_url":"https://github.com/douxxu.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌐 PiWave WebGUI\n\n\u003cdiv align=center\u003e\n\n![PiWave WebGUI image](https://piwave.xyz/static/img/logo.png)\n\n\u003c/div\u003e\n\n**PiWave WebGUI** is a web-based interface designed to manage and control your PiWave directly from your browser. It allows you to upload audio files, play, stop them, and view the current PiWave configuration through an easy-to-use interface.\n\n## Features\n\n- **Intuitive Web Interface**: Control your PiWave from a browser with an easy-to-use interface.\n- **File Management**: Upload, play, and stop MP3 audio files.\n- **Configuration Display**: View the current PiWave settings directly from the interface.\n- **Notifications**: Receive real-time notifications for actions like file uploads and audio playback.\n\n## Installation\n  \n\u003e [!WARNING]\n\u003e **Warning**: Using PiWave involves broadcasting signals which may be subject to local regulations and laws. It is your responsibility to ensure that your use of PiWave complies with all applicable legal requirements and regulations in your area. Unauthorized use of broadcasting equipment may result in legal consequences, including fines or penalties.\n\u003e\n\u003e **Liability**: The author of PiWave is not responsible for any damage, loss, or legal issues that may arise from the use of this software. By using PiWave, you agree to accept all risks and liabilities associated with its operation and broadcasting capabilities.\n\u003e\n\u003e Please exercise caution and ensure you have the proper permissions and knowledge of the regulations before using PiWave for broadcasting purposes.\n\n### Method 1: Full Install (with PiWave included)\n\nFor a complete installation of PiWave WebGUI with PiWave included, use the auto-install script:\n\n```bash\ncurl -sL https://setup.piwave.xyz/gui/full/ | sudo bash\n```\n\nThis script will install both PiWave WebGUI and PiWave, setting up the necessary dependencies and preparing your environment for immediate use.\n\n\u003e[!NOTE]\n\u003eTo uninstall full webgui, do the following command:\n\u003e```bash\n\u003ecurl -sL https://setup.piwave.xyz/gui/full/uninstall | sudo bash\n\u003e```\n\n### Method 2: WebGUI Install (PiWave must already be installed)\n\nIf you already have PiWave installed and configured, you can install only PiWave WebGUI using the dedicated installation script:\n\n```bash\ncurl -sL https://setup.piwave.xyz/gui/ | sudo bash\n```\n\nThis script will install PiWave WebGUI and the required dependencies to work with your existing PiWave setup.\n\n\u003e[!NOTE]\n\u003eTo uninstall full webgui, do the following command:\n\u003e```bash\n\u003ecurl -sL https://setup.piwave.xyz/gui/uninstall | sudo bash\n\u003e```\n\n## Usage\n\n1. **Start the Flask Server**: Run the Flask server to start the web interface.\n   \u003e[!NOTE]\n   \u003eYou must be running this as root user.\n   ```bash\n   sudo python3 $HOME/piwave-webgui/server.py\n   ```\n   or\n   ```bash\n   pw-webgui\n   ```\n\n\u003e [!NOTE]\n\u003e You can edit the configuration file `piwave.conf` to edit the piwave instance  \n\u003e Use `pw-webgui-config` as root user to open the file\n\n2. **Access the WebGUI**: Open your browser and navigate to `http://\u003cyour-raspberry-pi-ip\u003e` to access the PiWave WebGUI.\n\n3. **Upload and Manage Files**: Use the interface to upload MP3 files, play them, and stop playback.\n\n4. **View Configuration**: Check the current PiWave configuration directly from the web interface.\n\n## Requirements\n\n- **PiWave**: Ensure PiWave is installed and configured if you are using the WebGUI installation method.\n- **Flask**: Python web framework for the web interface.\n- **ffmpeg**: Required for audio file processing.\n\n## Error Handling\n\n- **Configuration Errors**: Ensure `piwave.conf` exists and is correctly formatted.\n- **Playback Issues**: Verify that your PiWave hardware is properly set up and connected.\n\n## License\n\nPiWave WebGUI is licensed under the GNU General Public License (GPL) v3.0. See the [LICENSE](LICENSE) file for more details.\n\n## Contributing\n\nContributions are welcome! Please submit a pull request or open an issue on [GitHub](https://github.com/douxxu/piwave-webgui/issues) for any bugs or feature requests.\n\n---\n\nThank you for using PiWave WebGUI!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouxxu%2Fpiwave-webgui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdouxxu%2Fpiwave-webgui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdouxxu%2Fpiwave-webgui/lists"}