Automated YouTube Audio/Video content transcription search for your website
# Install FFmpeg
brew install ffmpeg # MacOS
apt install ffmpeg # Linux
choco install ffmpeg # Windows (Chocolatey)
# Pip
python3 -m pip install git+https://github.com/algolia-samples/avsearch
# Wheel file (Download the latest release from https://github.com/algolia-samples/avsearch/releases)
python3 -m pip install avsearch-?.?.?-py3-none-any.whl
# From source
git clone https://github.com/algolia-samples/avsearch
cd avsearch
# https://python-poetry.org/docs/#installation
poetry install && poetry build
# Optionally, install the wheel file
python3 -m pip install ./dist/avsearch-?.?.?-py3-none-any.whl
# Or, use poetry's shell
poetry shellTo use this tool, you need an Algolia account. If you don't have one already, create an account for free. Note your Application ID during this process.
Once you have an account, your API Key can be located here. You don't need to create an Index to get started, Algolia will automatically create the index for us - just come up with a good name!
export ALGOLIA_APP_ID=<your-app-id>
export ALGOLIA_API_KEY=<your-api-key>
export ALGOLIA_INDEX_NAME=<your-index-name>
# Single video
av-search --targets "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
# Multiple videos
av-search --targets "https://youtu.be/dQw4w9WgXcQ,https://youtu.be/_C9PMLr_XC8"from avsearch import AVSearch
avs = AVSearch(app_id='AAAA1234', ...)
results = avs.transcribe(
["https://www.youtube.com/watch?v=zOz-Sk4K-64&list=PLuHdbqhRgWHLRlmvQ1OKLdjslSxXrAAjk"]
)This project is open source and welcomes contributions. We only ask that you adhere to our Code of Conduct when contributing and our process outlined below:
- After completing your change, run the
scripts/pre-commit.shscript to format and lint your code to fit our styling. This will run Black and Flake8 automatically with our settings. - Submit a Pull Request with your changes and request approval.
- Allow one week for your code to be reviewed by an Algolia team member. If changes are requested, these will need to be resolved before the changes are merged.