{"id":21233665,"url":"https://github.com/bdr-pro/bookifybot","last_synced_at":"2025-10-05T22:48:35.120Z","repository":{"id":239640916,"uuid":"800120535","full_name":"BDR-Pro/BookifyBot","owner":"BDR-Pro","description":"Bot in telegram to get download link of any audio book you want","archived":false,"fork":false,"pushed_at":"2024-05-13T18:37:55.000Z","size":4,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-15T02:44:07.763Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/BDR-Pro.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}},"created_at":"2024-05-13T18:31:39.000Z","updated_at":"2024-05-22T11:55:04.000Z","dependencies_parsed_at":null,"dependency_job_id":"8c7db52b-62a3-4b23-a372-b6595c4729b2","html_url":"https://github.com/BDR-Pro/BookifyBot","commit_stats":null,"previous_names":["bdr-pro/bookifybot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BDR-Pro/BookifyBot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FBookifyBot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FBookifyBot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FBookifyBot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FBookifyBot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BDR-Pro","download_url":"https://codeload.github.com/BDR-Pro/BookifyBot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FBookifyBot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278532358,"owners_count":26002346,"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-05T02:00:06.059Z","response_time":54,"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":[],"created_at":"2024-11-20T23:59:51.100Z","updated_at":"2025-10-05T22:48:35.089Z","avatar_url":"https://github.com/BDR-Pro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Audio Book Downloader Bot\n\nThis Telegram bot leverages the Telethon library to provide a simple interface for searching and downloading audio books. Users can interact with the bot to find books by title and download them directly through Telegram.\n\n## Features\n\n- **Search for Books**: Users can search for audio books by title.\n- **Book Selection**: After searching, users can select from a list of available books.\n- **Download Books**: Allows users to download the selected audio book and its cover image (if available).\n\n## Commands\n\n- `/start` - Start the conversation with the bot.\n- `/help` - Get help about how to use the bot.\n- `/search` - Initiate a search by entering a book title.\n\n## Setup\n\n1. **Clone the Repository**: Ensure you have a copy of the bot code.\n2. **Install Dependencies**:\n\n   ```bash\n   pip install telethon\n   ```\n\n3. **Environment Variables**:\n   - `API_ID`: Your Telegram API ID.\n   - `API_HASH`: Your Telegram API Hash.\n   - `TOKEN_BOOK`: The bot token from BotFather.\n\n4. **Run the Bot**:\n\n   ```bash\n   python main.py\n   ```\n\n## Operational Flow\n\n1. **Initialization**: Upon launching, the bot logs into the audio book service and starts listening for commands.\n2. **User Interaction**:\n   - Users can start the bot using the `/start` command, which will greet them and prompt to use the `/search` command.\n   - The `/help` command provides a quick guide on how to use the bot.\n   - The `/search` command prompts the user to send the title of the book they are looking for.\n   - The bot then displays a list of books. The user can select a book by sending its corresponding number.\n   - If the selected book is available, the bot fetches the book along with its cover image and provides a download link.\n\n## Error Handling\n\n- Users are informed if no books are found or if there is an error in downloading the book or its image.\n- The bot resets the conversation state if needed to avoid issues from lingering state errors.\n\n## Contribution\n\nContributions to the bot are welcome. Please ensure that you follow the existing coding style and add comments where necessary.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fbookifybot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdr-pro%2Fbookifybot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fbookifybot/lists"}