{"id":16199283,"url":"https://github.com/j6k4m8/pokkins","last_synced_at":"2026-04-20T03:36:55.256Z","repository":{"id":73813679,"uuid":"231459550","full_name":"j6k4m8/pokkins","owner":"j6k4m8","description":"Create a podcast from a directory of audio-files, with zero-config.","archived":false,"fork":false,"pushed_at":"2020-11-27T00:52:59.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-07T17:47:01.806Z","etag":null,"topics":["docker","ohp","podcast","zero-config"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/j6k4m8.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":"2020-01-02T21:05:54.000Z","updated_at":"2020-11-27T00:53:01.000Z","dependencies_parsed_at":null,"dependency_job_id":"13974ddd-2776-4fdc-8818-1e619a1a966f","html_url":"https://github.com/j6k4m8/pokkins","commit_stats":{"total_commits":9,"total_committers":2,"mean_commits":4.5,"dds":0.4444444444444444,"last_synced_commit":"298121bdd23df4786900eb56116fab11f28b7c2f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/j6k4m8/pokkins","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fpokkins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fpokkins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fpokkins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fpokkins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/j6k4m8","download_url":"https://codeload.github.com/j6k4m8/pokkins/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/j6k4m8%2Fpokkins/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266287827,"owners_count":23905461,"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":["docker","ohp","podcast","zero-config"],"created_at":"2024-10-10T09:24:55.554Z","updated_at":"2026-04-20T03:36:50.207Z","avatar_url":"https://github.com/j6k4m8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎧 pokkins\n\nZero-config podcast hosting.\n\n## use-case\n\nI have a directory full of audio-files on a server, and I want them to be accessible as a podcast.\n\n## usage \n\nOpen the directory you want to serve:\n\n```shell\n$ cd my-audio\n$ ls\nEpisode1.mp4\nEpisode2.mp4\n```\n\n## docker approach \n\nStart the `pokkins` Docker container:\n\n\n```shell\n$ docker build --rm -t pokkins .\n$ docker run -it --rm -v $(pwd):/mnt/vin/eps -p 8092:8092 pokkins\n```\n\nIf you can guarantee that this host will remain static and publicly accessible, then you can submit `http://[host]:8092/feed.xml` as a podcast URL to most podcast apps. \n\n\n## native python approach:\n\nNote that you may first need to install dependencies with `poetry install`.\n\n```shell\n$ python3 -c \"from pokkins import Pokkins; print(Pokkins('eps').generate_rss())\" \u003e feed.xml\n```\n\nYou can now serve the directory over HTTP. One simple way to do this:\n\n```shell\n$ python3 -m http.server 8092\n```\n\nThis hosts the feed XML and the episodes; rather than running a python http server (which is jank!!), you can also upload the whole thing to an s3 bucket, for example.\n\n## faq\n\n#### i came here because i wanted to start a podcast! this looks hard!\n\nmehhh yeah it is, email me at opensource-at-matelsky-dot-com and I'll try to help you\n\n#### how do i add tags? how do I add episode descriptions?\n\nright now, you can't. but if you want those features, ① consider using a more advanced podcast syndication service (this one is really just bare-bones to get something running with zero config, and has no bells or whistles) ②  make a new Issue or Pull Request and I'll try to triage!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj6k4m8%2Fpokkins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fj6k4m8%2Fpokkins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fj6k4m8%2Fpokkins/lists"}