{"id":29223599,"url":"https://github.com/kdklv/pond","last_synced_at":"2026-04-22T21:33:37.109Z","repository":{"id":301714004,"uuid":"1008676463","full_name":"kdklv/pond","owner":"kdklv","description":"Pond: A minimalist, offline media player for Raspberry Pi. Turn your USB drive into a personal dumb-TV channel with instant playback and smart playlists.","archived":false,"fork":false,"pushed_at":"2026-02-27T18:52:11.000Z","size":4679,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-27T22:58:46.669Z","etag":null,"topics":["dumb-tv","media-player","mpv","offline-media","python","raspberry-pi","smart-playlists"],"latest_commit_sha":null,"homepage":"","language":"Python","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/kdklv.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}},"created_at":"2025-06-25T23:30:55.000Z","updated_at":"2025-06-29T20:29:21.000Z","dependencies_parsed_at":"2025-06-28T11:48:50.213Z","dependency_job_id":null,"html_url":"https://github.com/kdklv/pond","commit_stats":null,"previous_names":["kdklv/pond"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kdklv/pond","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdklv%2Fpond","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdklv%2Fpond/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdklv%2Fpond/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdklv%2Fpond/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kdklv","download_url":"https://codeload.github.com/kdklv/pond/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kdklv%2Fpond/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32156602,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T17:06:48.269Z","status":"ssl_error","status_checked_at":"2026-04-22T17:06:19.037Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["dumb-tv","media-player","mpv","offline-media","python","raspberry-pi","smart-playlists"],"created_at":"2025-07-03T05:05:33.062Z","updated_at":"2026-04-22T21:33:37.071Z","avatar_url":"https://github.com/kdklv.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🪷 PondTV ⛲\n\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"logo.png\" alt=\"PondTV Logo\" width=\"256\"/\u003e\n\u003c/p\u003e\n\n\u003e A calm, offline alternative to streaming services—content flows from your personal collection. Just power on and watch.\n\nPondTV turns your Raspberry Pi into a plug-and-play TV channel for your media. Think of it as a dumb-TV, just like dumb-phones: no apps, no menus, just simple playback from your USB drive. \n\n## 🐸 Features\n\n- **Instant-On Playback** - Boots straight into fullscreen media\n- **Smart Playlists** - Prevents binge-watching by intelligently selecting the next episode in a series\n- **Channel Surfing** - Simple controls to switch content\n- **Offline First** - No internet required after setup\n- **Content Tracking** - Remembers what you've watched and where you left off\n- **Robust USB Handling** - Reliably detects and mounts USB drives on-the-fly\n\n## 🌿 Preparing Your Media\n\nOrganize your files on a USB drive like this:\n\n```\nUSB_DRIVE/\n├── Movies/\n│   └── Movie Title (Year).mkv\n└── TV_Shows/\n    └── ShowName/\n        └── Season 01/\n            └── ShowName - S01E01 - Episode.mp4\n```\n\nSee the `examples/` folder for a working example you can copy.\n\n## 🍀 Installation\n\nThe recommended installation method is to use the command below, which will download and run the installer automatically. This works for a fresh Raspberry Pi OS installation with SSH enabled.\n\n```bash\ncurl -sSL https://raw.githubusercontent.com/kdklv/pond/main/scripts/install.sh | sudo bash\n```\n\nFor headless setup without a keyboard or monitor attached, you can pre-configure the Raspberry Pi OS with WiFi and place the installer script on the boot partition to have it run automatically on first boot. Please refer to the Raspberry Pi documentation for details on headless setup.\n\n## 🌀 Controls\n\n| Key | Action |\n|-----|--------|\n| **Space** | Play/Pause |\n| **→** | Next video |\n| **←** | Previous video |\n| **↑/↓** | Volume up/down |\n| **Backspace** | Restart current video |\n| **M** | Toggle mute |\n| **S** | Mark as seen (skip to next) |\n| **I/P** | Toggle guide |\n| **Esc** | Quit |\n\n## 🏊 Configuration\n\nPondTV creates a `config.yml` on your USB drive for customization. The app will generate default settings on first run.\n\n## 🏝 Future Ideas\n\n- **Random Mode** - Shuffle content randomly, mimicking flipping through TV channels\n- **Commercial Breaks** - Insert commercials between content for nostalgic TV feel\n- **Visual Effects** - Add filters and effects to playback \n- **Flashable OS Image** - Complete SD card image with PondTV pre-installed\n- **Web Interface** - Manage your library through a browser\n- **Multiple USB Support** - Handle content from several drives\n\n## 🤝 Contributing\n\nContributions welcome! Please feel free to submit a Pull Request.\n\n## 📄 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n---\n\n**PondTV** — Your personal, offline TV channel. Simple, like still water. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdklv%2Fpond","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkdklv%2Fpond","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkdklv%2Fpond/lists"}