{"id":31723317,"url":"https://github.com/filiprojek/walauncher","last_synced_at":"2025-10-09T04:48:47.156Z","repository":{"id":249141415,"uuid":"830217963","full_name":"filiprojek/walauncher","owner":"filiprojek","description":"A lightweight launcher for your web apps, an alternative to Muximux","archived":false,"fork":false,"pushed_at":"2025-01-23T18:28:27.000Z","size":670,"stargazers_count":3,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T18:31:43.703Z","etag":null,"topics":["bookmark","htpc","iframe","landing-page","muximux","radarr","sonarr"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/filiprojek.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-07-17T20:48:11.000Z","updated_at":"2025-01-23T18:25:13.000Z","dependencies_parsed_at":"2024-07-18T20:00:30.125Z","dependency_job_id":"b18ea282-5a37-4fef-a220-0218fb988035","html_url":"https://github.com/filiprojek/walauncher","commit_stats":null,"previous_names":["filiprojek/walauncher"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/filiprojek/walauncher","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filiprojek%2Fwalauncher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filiprojek%2Fwalauncher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filiprojek%2Fwalauncher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filiprojek%2Fwalauncher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filiprojek","download_url":"https://codeload.github.com/filiprojek/walauncher/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filiprojek%2Fwalauncher/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000697,"owners_count":26082921,"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-10-09T02:00:07.460Z","response_time":59,"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":["bookmark","htpc","iframe","landing-page","muximux","radarr","sonarr"],"created_at":"2025-10-09T04:48:44.224Z","updated_at":"2025-10-09T04:48:47.148Z","avatar_url":"https://github.com/filiprojek.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WALauncher\n\nWALauncher is a web-based launcher designed as an alternative to [Muximux](https://github.com/mescon/Muximux), primarily used for managing various web services like Servarr apps. However, it can be configured to launch and manage any web application.\n\n## Screenshots\n\n#### Desktop home page view\n![Home page](.screenshots/home.png)\n\n#### Desktop in app view\n![Apps overview](.screenshots/apps.png)\n\n#### Mobile app view\n![Apps overview on mobile](.screenshots/mobile.jpg)\n\n## Usage\n\n### Using Docker\n\n1. **Create docker-compose.yaml**\n\n   Create a `docker-compose.yaml` file in your project directory:\n\n   ```yaml\n   services:\n     walauncher:\n       image: filiprojek/walauncher:latest\n       container_name: walauncher\n       ports:\n         - 5200:80\n       volumes:\n         - ./walauncher/config.json:/var/www/html/config.json\n         - ./walauncher/img/:/var/www/html/img/\n       restart: unless-stopped\n   ```\n\n2. **Start and Stop the Compose**\n\n   Start the containers:\n\n   ```bash\n   docker-compose up -d\n   ```\n\n   Stop the containers:\n\n   ```bash\n   docker-compose down\n   ```\n\n3. **Configuration**\n\n   - `cd` to a newly created `walauncher` folder\n   - Remove the `config.json` folder if it exists.\n   - Create a `config.json` file in the project root with the following structure:\n\n     ```json\n     {\n         \"apps\": [\n             {\n                 \"name\": \"Some service\",\n                 \"img\": \"image_name.jpg\",\n                 \"url\": \"http://localhost:8000/\"\n             },\n             {\n                 \"name\": \"Some service\",\n                 \"img\": \"image_name.jpg\",\n                 \"url\": \"http://localhost:8100/\"\n             }\n         ]\n     }\n     ```\n\n   Replace `\"Some service\"`, `\"image_name.jpg\"`, and `\"http://localhost:8000/\"` with your own service names, image filenames in the `img/` folder, and their respective URLs.\n\n3. **Upload Icons and Images**\n\n   Upload your service icons (`.svg`, `.jpg`, etc.) to the `walauncher/img/` folder.\n\n### Manual Setup (Without Docker)\n\n1. **Setup Web Server**\n\n   Download the repository and serve it using a web server of your choice (e.g., Apache, Nginx).\n\n2. **Configuration**\n\n   - Create a `config.json` file in the project root with the following structure:\n\n     ```json\n     {\n         \"apps\": [\n             {\n                 \"name\": \"Some service\",\n                 \"img\": \"image_name.jpg\",\n                 \"url\": \"http://localhost:8000/\"\n             },\n             {\n                 \"name\": \"Some service\",\n                 \"img\": \"image_name.jpg\",\n                 \"url\": \"http://localhost:8100/\"\n             }\n         ]\n     }\n     ```\n\n   Replace `\"Some service\"`, `\"image_name.jpg\"`, and `\"http://localhost:8000/\"` with your own service names, image filenames in the `img/` folder, and their respective URLs.\n\n3. **Upload Icons and Images**\n\n   Upload your service icons (`.svg`, `.jpg`, etc.) to the `img/` folder in the project root.\n\n4. **Start the Web Server**\n\n   Once configured, start your web server to serve walauncher.\n\n## Configuration\n\nWALauncher supports additional optional configuration options to enhance customization. These options allow you to modify the behavior and appearance of the web application by adding an options object in the `config.json` file\n\n### Example `config.json` with Options\n\n```json\n{\n    \"apps\": [\n        {\n            \"name\": \"Some service\",\n            \"img\": \"image_name.jpg\",\n            \"url\": \"http://localhost:8000/\"\n        },\n        {\n            \"name\": \"Some service\",\n            \"img\": \"image_name.jpg\",\n            \"url\": \"http://localhost:8100/\"\n        }\n    ],\n    \"options\": {\n        \"footer\": true,\n        \"footertext\": \"Your customized footer where you can use \u003cstrong\u003eHTML\u003c/strong\u003e\",\n        \"title\": \"My Home Launcher\"\n    }\n}\n```\n\n### Options\n\n- **footer** (boolean, default: `true`): Control the visibility of the footer.\n  - Set `footer` to `false` to hide the footer completely from the site.\n\n- **footertext** (string, optional): Customize the content of the footer.\n  - Use this option to provide custom text for the footer. You can use HTML for formatting.\n\n- **title** (string, optional): Customize the document title.\n  - Change `title` to another value to customize the title displayed in the browser's title bar.\n\nThese options are entirely optional. If not specified, the default behavior will be applied.\n\n## Contributing\n\nContributions are welcome! Fork the repository and submit a pull request with your changes.\n\n## Bug Reporting\n\nIf you encounter any bugs or issues, please report them [here](https://github.com/filiprojek/walauncher/issues).\n\n## License\n\nThis project is licensed under the GNU General Public License v3.0 (GPL-3.0).\n\n## Docker Image\n\nAn official Docker image for walauncher is available on Docker Hub:\n[filiprojek/walauncher](https://hub.docker.com/r/filiprojek/walauncher)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiliprojek%2Fwalauncher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffiliprojek%2Fwalauncher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffiliprojek%2Fwalauncher/lists"}