{"id":13567172,"url":"https://github.com/amsehili/genRSS","last_synced_at":"2025-04-04T01:31:09.441Z","repository":{"id":23818153,"uuid":"27194796","full_name":"amsehili/genRSS","owner":"amsehili","description":"genRSS generates an RSS 2.0 feed from media files in a directory","archived":false,"fork":false,"pushed_at":"2024-12-11T16:34:34.000Z","size":176,"stargazers_count":137,"open_issues_count":8,"forks_count":46,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-03-13T02:48:41.394Z","etag":null,"topics":["feed","podcast-generator","rss"],"latest_commit_sha":null,"homepage":"https://github.com/amsehili/genRSS","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amsehili.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":"2014-11-26T20:26:15.000Z","updated_at":"2025-03-12T14:50:39.000Z","dependencies_parsed_at":"2024-12-01T13:26:43.800Z","dependency_job_id":"6a1a3bbd-465e-4dcb-8b81-05ce74fa6578","html_url":"https://github.com/amsehili/genRSS","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amsehili%2FgenRSS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amsehili%2FgenRSS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amsehili%2FgenRSS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amsehili%2FgenRSS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amsehili","download_url":"https://codeload.github.com/amsehili/genRSS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247107816,"owners_count":20884793,"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":["feed","podcast-generator","rss"],"created_at":"2024-08-01T13:02:25.298Z","updated_at":"2025-04-04T01:31:09.435Z","avatar_url":"https://github.com/amsehili.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# genRSS\n\n[![Build Status](https://github.com/amsehili/genRSS/actions/workflows/ci.yml/badge.svg)](https://github.com/amsehili/genRSS/actions/workflows/ci.yml/)\n\n`genRSS` is a tool for generating an RSS 2.0 feed from media files within a\ndirectory. It can search for files recursively in subdirectories and restrict\nthe search to specific file extensions.\n\n## Installation\n\nNote: Another package named `genrss` already exists on PyPI. To install `genRSS`,\nplease use `generss` (with an *e* after the *n*):\n\n```bash\npip install generss\n```\n\nOnce installed, you can run `genRSS` directly from the command line.\n\n## Determining Media File Duration\n\nTo include the duration of media files in your feeds (via the\n`\u003citunes:duration\u003e` tag), `genRSS` attempts to determine the duration using the\nfollowing tools, in order of preference:\n\n1. **`mutagen`**: a python package (automatically installed if you install\n   `genRSS` with `pip`) that supports both audio and video files.\n2. **`sox`**: command-line tool, handles only audio files but is faster than\n   `ffprobe`.\n3. **`ffprobe`**: command-line tool, supports both audio and video files but\n   is the slowest option.\n\nIf `genRSS` is unable to determine the media file duration using one tool, it\nwill automatically fall back to the next one in the list. If none of these tools\nis available or if the file duration can't be retrieved, the `\u003citunes:duration\u003e`\ntag will not be included in the feed.\n\n\n## Episode Descriptions\n\nText files with a `.txt` extension are automatically used to provide\ndescriptions for media files that share the same name but have different\nextensions. As a result, files ending in `.txt` cannot be used as feed items.\n\n\n\n## Usage options\n\nType `genRSS -h` to show the usage options:\n\n```\n  -d DIRECTORY, --dirname DIRECTORY\n                        Directory to look for media files in.\n                        This directory name will be appended to the host name\n                        to create absolute paths to your media files.\n  -r, --recursive       Look for media files recursively in subdirectories\n                        [Default:False]\n  -e STRING, --extensions STRING\n                        A comma separated list of extensions (e.g. mp3,mp4,avi,ogg)\n                        [Default: all files]\n  -o FILE, --out FILE   Output RSS file [default: stdout]\n  -H URL, --host URL    Host name (or IP address), possibly with a protocol\n                        (default: http) a port number and the path to the base\n                        directory where your media directory is located.\n                        Examples of host names:\n                         - http://localhost:8080 [default]\n                         - mywebsite.com/media/JapaneseLessons\n                         - mywebsite\n                         - 192.168.1.12:8080\n                         - http://192.168.1.12/media/JapaneseLessons\n  -i URL, --image URL   Absolute or relative URL for feed's image [default: None]\n  -M, --metadata        Use media files' metadata to extract item title [default: False]\n  -t STRING, --title STRING\n                        Title of the podcast [Default: use directory name as title]\n  -p STRING, --description STRING\n                        Description of the podcast [Default:None]\n  -C, --sort-creation   Sort files by date of creation instead of name (default)\n  -v, --verbose         set verbose [default: False]\n```\n\n\n### License\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famsehili%2FgenRSS","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famsehili%2FgenRSS","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famsehili%2FgenRSS/lists"}