{"data":{"slug":"readbeyond-aeneas","name":"aeneas","tagline":"Python library and tools for audio-text synchronization","github_url":"https://github.com/readbeyond/aeneas","owner":"readbeyond","repo":"aeneas","owner_avatar_url":"https://avatars.githubusercontent.com/u/5318774?v=4","primary_language":"Python","stars":2866,"forks":277,"topics":["alignment","audio","cli","dtw","espeak","espeak-ng","festival","ffmpeg","forced-alignment","linux","macos","nlp","python","smil","speech","srt","text","text-to-speech","tts","windows"],"archived":false,"github_pushed_at":"2026-07-25T10:22:31+00:00","maintenance_label":"Steady","stars_delta_30d":11,"url":"https://www.graphcanon.com/tools/readbeyond-aeneas","markdown_url":"https://www.graphcanon.com/tools/readbeyond-aeneas.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/readbeyond-aeneas","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=readbeyond-aeneas","description":"aeneas is a Python/C library and a set of tools to automagically synchronize audio and text (aka forced alignment)","homepage_url":"http://www.readbeyond.it/aeneas/","license":"AGPL-3.0","open_issues":37,"watchers":64,"ai_summary":"Aeneas is a Python/C library and set of command-line tools designed to align text with corresponding spoken words in audio files, crucial for forced alignment applications.","readme_excerpt":"## System Requirements, Supported Platforms and Installation\n\n---\n\n### System Requirements\n\n1. a reasonably recent machine (recommended 4 GB RAM, 2 GHz 64bit CPU)\n2. [Python](https://python.org/) 2.7 (Linux, OS X, Windows) or 3.5 or later (Linux, OS X)\n3. [FFmpeg](https://www.ffmpeg.org/)\n4. [eSpeak](http://espeak.sourceforge.net/)\n5. Python packages `BeautifulSoup4`, `lxml`, and `numpy`\n6. Python headers to compile the Python C/C++ extensions (optional but strongly recommended)\n7. A shell supporting UTF-8 (optional but strongly recommended)\n\n---\n\n### Installation\n\nAll-in-one installers are available for Mac OS X and Windows,\nand a Bash script for deb-based Linux distributions (Debian, Ubuntu)\nis provided in this repository.\nIt is also possible to download a VirtualBox+Vagrant virtual machine.\nPlease see the\n[INSTALL file](https://github.com/readbeyond/aeneas/blob/master/wiki/INSTALL.md)\nfor detailed, step-by-step installation procedures for different operating systems.\n\nThe generic OS-independent procedure is simple:\n\n1. **Install**\n   [Python](https://python.org/) (2.7.x preferred),\n   [FFmpeg](https://www.ffmpeg.org/), and\n   [eSpeak](http://espeak.sourceforge.net/)\n\n2. Make sure the following **executables** can be called from your **shell**:\n   `espeak`, `ffmpeg`, `ffprobe`, `pip`, and `python`\n\n3. First install `numpy` with `pip` and then `aeneas` (this order is important):\n\n    ```bash\n    pip install numpy\n    pip install aeneas\n    ```\n\n4. To **check** whether you installed **aeneas** correctly, run:\n\n   ```bash\n    python -m aeneas.diagnostics\n    ```\n\n---\n\n## License\n\n**aeneas** is released under the terms of the\nGNU Affero General Public License Version 3.\nSee the\n[LICENSE file](https://github.com/readbeyond/aeneas/blob/master/LICENSE) for details.\n\nLicenses for third party code and files included in **aeneas**\ncan be found in the\n[licenses](https://github.com/readbeyond/aeneas/blob/master/licenses/README.md) directory.\n\nNo copy rights were harmed in the making of this project.","github_created_at":"2015-05-11T11:19:46+00:00","created_at":"2026-07-11T12:08:19.713636+00:00","updated_at":"2026-09-20T07:08:03.836581+00:00","categories":[{"slug":"speech-audio","name":"Speech & Audio","url":"https://www.graphcanon.com/categories/speech-audio","markdown_url":"https://www.graphcanon.com/categories/speech-audio.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/speech-audio"}],"tags":[{"slug":"alignment","name":"alignment"},{"slug":"audio","name":"audio"},{"slug":"cli","name":"cli"},{"slug":"dtw","name":"dtw"},{"slug":"forced-alignment","name":"forced-alignment"},{"slug":"nlp","name":"nlp"},{"slug":"speech","name":"speech"},{"slug":"tts","name":"tts"}],"trust":{"provenance":{"is_fork":false,"github_id":35419406,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-09-20T07:08:01.356Z","maintenance":{"label":"Steady","score":60,"methodology":"github_public_v1","releases_90d":0,"days_since_push":56,"last_release_at":"2017-03-16T12:50:13Z","stars_delta_30d":11,"open_issues_delta_30d":0},"security_summary":{"status":"findings","scanner":"osv@v1","low_count":24,"high_count":0,"last_scan_at":"2026-07-11T12:08:22.711Z","medium_count":0,"scan_profile":"deps","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-09-20T07:08:02.411Z"},"languages":{"value":["python"],"source":"github.language","observed_at":"2026-09-20T07:08:02.411Z"},"license_spdx":{"value":"AGPL-3.0","source":"github.license","observed_at":"2026-09-20T07:08:02.411Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":{"notes":["Python 2.7 or later","FFmpeg","eSpeak","Numpy, BeautifulSoup4, lxml as Python packages"],"min_ram_gb":4,"requires_docker":false},"constraints":{"min_ram_gb":4,"requires_docker":false},"when_to_use":["When you need precise alignment of text with spoken words in audio files, as Aeneas excels at forced alignment tasks","If your project requires integration into existing Python workflows that demand high performance and accuracy"],"when_not_to_use":["Avoid if your system cannot meet the minimum requirements for Python versions below 3.5 or lacks essential dependencies such as FFmpeg or eSpeak","Do not use when a more lightweight solution suffices, as Aeneas includes comprehensive but resource-intensive C/C++ extensions"],"source":"enrich:decision_facts","observed_at":"2026-07-17T03:22:36.672Z"},"constraint_facets":{"min_ram_gb":4,"requires_docker":false},"decision_summary":[{"label":"Requirements","value":"Min 4 GB RAM; Python 2.7 or later; FFmpeg; eSpeak; Numpy, BeautifulSoup4, lxml as Python packages"},{"label":"Adopt for","value":"Aeneas is a Python library and CLI toolset for audio-text synchronization specifically designed to address forced alignment needs."}]}}