{"id":19745532,"url":"https://github.com/franckferman/whisper_transcriber","last_synced_at":"2025-11-03T23:04:20.737Z","repository":{"id":261896523,"uuid":"885661689","full_name":"franckferman/whisper_transcriber","owner":"franckferman","description":"A tool to transcribe audio files using OpenAI's Whisper API.","archived":false,"fork":false,"pushed_at":"2024-11-09T04:04:55.000Z","size":30,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-27T18:43:21.747Z","etag":null,"topics":["audio","audio-transcription","openai","openai-python","openai-whisper","python","python-3","python-openai","python-script","python-wrapper","python3","python3-wrapper","transcription-processing","transcription-tool","whisper-ai","whisper-integration","whisper-transcriber"],"latest_commit_sha":null,"homepage":"https://github.com/franckferman/whisper_transcriber","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/franckferman.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":"2024-11-09T04:02:48.000Z","updated_at":"2024-11-09T04:08:28.000Z","dependencies_parsed_at":"2024-11-09T05:28:32.910Z","dependency_job_id":null,"html_url":"https://github.com/franckferman/whisper_transcriber","commit_stats":null,"previous_names":["franckferman/whisper_transcriber"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franckferman%2Fwhisper_transcriber","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franckferman%2Fwhisper_transcriber/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franckferman%2Fwhisper_transcriber/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/franckferman%2Fwhisper_transcriber/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/franckferman","download_url":"https://codeload.github.com/franckferman/whisper_transcriber/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241077146,"owners_count":19905725,"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":["audio","audio-transcription","openai","openai-python","openai-whisper","python","python-3","python-openai","python-script","python-wrapper","python3","python3-wrapper","transcription-processing","transcription-tool","whisper-ai","whisper-integration","whisper-transcriber"],"created_at":"2024-11-12T02:09:21.963Z","updated_at":"2025-11-03T23:04:20.695Z","avatar_url":"https://github.com/franckferman.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Whisper Transcriber\n\n**Whisper Transcriber** is a command-line application designed to transcribe audio files using OpenAI's Whisper API. \nIt includes features for language selection, logging, and cleanup of temporary files, with built-in checks for file validity and size before processing.\n\n---\n\n## Features\n- Transcribe audio files using OpenAI's Whisper API.\n- Language selection for transcription (`fr` for French, `en` for English).\n- Logging for debugging and tracking transcription activities.\n- Automatic cleanup of temporary files such as `.pyc`, `__pycache__`, etc.\n\n---\n\n## Installation\n\n### Prerequisites\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/franckferman/whisper-transcriber.git\n   cd whisper-transcriber\n   ```\n2. Install dependencies with [Poetry](https://python-poetry.org/):\n   ```bash\n   poetry install\n   ```\n\n3. Alternatively, you can use pip:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n---\n\n## Usage\n\n### Transcription\nTo transcribe an audio file, use the following command:\n\n```bash\npoetry run whisper-transcriber transcribe -f \u003cpath_to_audio_file\u003e -k \u003cAPI_KEY\u003e -l \u003clanguage_code\u003e\n```\n\n#### Example\n```bash\npoetry run whisper-transcriber transcribe -f \"audio/sample.mp3\" -k \"your_openai_api_key\" -l \"en\"\n```\n\n#### Options\n- `-f`, `--file`: Path to the audio file to transcribe.\n- `-k`, `--key`: OpenAI API key for authentication.\n- `-l`, `--lang`: Language code for transcription (`fr` or `en`).\n- `-o`, `--output`: File path to save the transcription output as JSON.\n- `--debug`: Enable debug logging, which creates a log file `transcription.log`.\n\n### Cleanup\nTo remove temporary files and logs from the project directory:\n\n```bash\npoetry run whisper-transcriber clean --log\n```\n\n#### Options\n- `--log`: Enable logging for the cleanup process.\n\n---\n\n## Development\n\n### Running Tests\nTo test the transcription and cleanup functions, ensure all necessary dependencies are installed:\n```bash\npoetry install --with dev\n```\n\nThen, run tests using your preferred test runner.\n\n### Formatting\n- The project uses `black`, `flake8`, and `mypy` for formatting, linting, and type-checking.\n  - Format code with: `black .`\n  - Lint code with: `flake8 .`\n  - Type-check code with: `mypy .`\n\n---\n\n## License\n\nThis project is licensed under the GNU AGPLv3. See the `LICENSE` file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffranckferman%2Fwhisper_transcriber","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffranckferman%2Fwhisper_transcriber","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffranckferman%2Fwhisper_transcriber/lists"}