{"id":51007121,"url":"https://github.com/o1298098/appletv-remote","last_synced_at":"2026-06-20T21:30:56.931Z","repository":{"id":349462054,"uuid":"1201098390","full_name":"o1298098/appletv-remote","owner":"o1298098","description":"Self-hosted web remote for Apple TV using pyatv and FastAPI","archived":false,"fork":false,"pushed_at":"2026-06-05T14:54:21.000Z","size":419,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-05T16:25:55.183Z","etag":null,"topics":["apple-tv","fastapi","pyatv","remote-control"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/o1298098.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2026-04-04T07:54:49.000Z","updated_at":"2026-06-05T14:54:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/o1298098/appletv-remote","commit_stats":null,"previous_names":["o1298098/appletv-remote"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/o1298098/appletv-remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o1298098%2Fappletv-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o1298098%2Fappletv-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o1298098%2Fappletv-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o1298098%2Fappletv-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/o1298098","download_url":"https://codeload.github.com/o1298098/appletv-remote/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/o1298098%2Fappletv-remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34586666,"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-20T02:00:06.407Z","response_time":98,"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":["apple-tv","fastapi","pyatv","remote-control"],"created_at":"2026-06-20T21:30:56.868Z","updated_at":"2026-06-20T21:30:56.923Z","avatar_url":"https://github.com/o1298098.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Apple TV Remote · Web UI\n\nWeb client for controlling Apple TV on your LAN. In production the FastAPI backend serves the built SPA in the same process; \n\n![UI preview](frontend/docs/preview.png)\n\n## Local development\n\n1. Install frontend dependencies:\n   - `cd frontend`\n   - `npm ci` (or `npm install`)\n2. Install backend dependencies in a Python virtual environment:\n   - `cd ../backend`\n   - `python -m venv .venv`\n   - Activate venv:\n     - PowerShell: `.venv\\Scripts\\Activate.ps1`\n     - bash/zsh: `source .venv/bin/activate`\n   - `pip install -r requirements.txt`\n3. Start the API from `backend` (default port **8765**):\n   - `uvicorn main:app --host 0.0.0.0 --port 8765`\n4. In another terminal, start the frontend dev server from `frontend`:\n   - `cd frontend`\n   - `npm run dev`\n   - Vite proxies `/api` to `http://127.0.0.1:8765` (see `frontend/vite.config.ts`).\n\n## Production build\n\n```bash\nnpm run build\n```\n\nOutput goes to `dist/`. The root Docker image copies that folder into the container so `uvicorn` can serve both the SPA and `/api`.\n\n## Deployment \n\nFrom the **repository root**:\n\n```bash\ndocker build -t apple-tv-remote .\ndocker run --rm -p 8765:8765 -v atv-data:/data apple-tv-remote\n```\n\nOr with Compose:\n\n```bash\ndocker compose up --build\n```\n\nOpen **http://localhost:8765** in your browser. Pairing data is persisted under the container volume `/data` (see `PYATV_STORAGE`).\n\n\u003e **Note:** If the container cannot discover Apple TVs on your LAN (common on Linux with bridge networking), switch to `network_mode: host` in `docker-compose.yml` as described in the comments there (use either host networking or `ports`, not both).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo1298098%2Fappletv-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fo1298098%2Fappletv-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fo1298098%2Fappletv-remote/lists"}