{"id":13826782,"url":"https://github.com/codenamewei/youtube2text","last_synced_at":"2026-01-17T03:24:47.367Z","repository":{"id":42980317,"uuid":"443489779","full_name":"codenamewei/youtube2text","owner":"codenamewei","description":"Converts Youtube URLs to Text with Speech Recognition","archived":false,"fork":false,"pushed_at":"2022-10-18T16:33:22.000Z","size":69,"stargazers_count":28,"open_issues_count":6,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-11-29T04:44:06.835Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/codenamewei.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-01T07:10:16.000Z","updated_at":"2025-11-03T11:27:43.000Z","dependencies_parsed_at":"2022-09-19T18:03:08.184Z","dependency_job_id":null,"html_url":"https://github.com/codenamewei/youtube2text","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/codenamewei/youtube2text","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenamewei%2Fyoutube2text","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenamewei%2Fyoutube2text/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenamewei%2Fyoutube2text/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenamewei%2Fyoutube2text/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codenamewei","download_url":"https://codeload.github.com/codenamewei/youtube2text/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codenamewei%2Fyoutube2text/sbom","scorecard":{"id":296962,"data":{"date":"2025-08-11","repo":{"name":"github.com/codenamewei/youtube2text","commit":"2171b634f68da764c336eaf48f83cb3c9763a7a4"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/6 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 28 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T19:47:32.340Z","repository_id":42980317,"created_at":"2025-08-17T19:47:32.340Z","updated_at":"2025-08-17T19:47:32.340Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28492844,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T02:39:23.645Z","status":"ssl_error","status_checked_at":"2026-01-17T02:34:19.649Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-08-04T09:01:44.064Z","updated_at":"2026-01-17T03:24:47.326Z","avatar_url":"https://github.com/codenamewei.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\n## 🔊 Converts Youtube URLs to Text with Speech Recognition \n\n\u003cp\u003e\n  \u003cp align=\"center\"\u003e\n\u003cimg alt=\"project status: active\" src=\"https://img.shields.io/badge/Project%20Status-%F0%9F%94%A5Active-brightgreen\"\u003e \u003cimg alt=\"supported language: english\" src=\"https://img.shields.io/badge/Supported%20Language-English-blueviolet\"\u003e\n\n\u003c/p\u003e\n\n\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"banner\" src=\"https://user-images.githubusercontent.com/33477318/147850310-902fa3c3-910c-48de-815a-9e8f54487d73.jpg\" width=\"800\"\u003e\u003cbr\u003e\n\u003c/div\u003e\n\n### 💡 What does the library does?\n\n- **Youtube -\u003e Text**: Translate youtube urls as text file (csv)\n- **Youtube -\u003e Audio**: Downloads youtube urls as audio file (wav, flac)\n- **Audio -\u003e Text**: Translate audio file (wav, flac) to text file (csv)\n\n\nThree folders will be created to store the output files.  \n```\n\u003cOwn Path\u003e or \u003cHOME_DIRECTORY\u003e/youtube2text\n│\n├── audio/\n│   └── 2022Jan02_011802.flac\n|\n├── audio-chunks/\n│   └── 2022Jan02_011802\n│       ├── chunk1.flac\n│       ├── chunk2.flac\n│       └── chunk3.flac\n│   \n└── text/\n    └── 2022Jan02_011802.csv\n```\n\n\n### :package: How to install\nInstall and update using [pip](https://pypi.org/project/youtube2text/)\n```\npip install youtube2text\n```\n\n\n### 🔧Build from source \n```\ngit clone \u003cthis_repo\u003e\ncd \u003cthis_repo\u003e\npython setup.py install\n```\n\n### ✨ How to use \n- Using the library requires **internet connection** for both downloading youtube videos and speech recognition operation\n```\nfrom youtube2text import Youtube2Text\n\nconverter = Youtube2Text()\n\nconverter.url2text(urlpath=\"https://www.youtube.com/watch?v=Ad9Q8rM0Am0\u0026t=114s\")\n```\n\nCheck out more at [howtouse.ipynb](tests/howtouse.ipynb)\n\n### 📌 Functions \n- Support audio output of   \n    - wav\n    - flac\n- Support Automatic Speech Recognition with [speech-recognition library](https://pypi.org/project/SpeechRecognition/)\n\n#### Youtube -\u003e Text\n```\ndef url2text(self, urlpath, outfile = None, audioformat = \"flac\", audiosamplingrate=16000):\n    '''\n    Convert youtube url to text\n\n    Parameters:\n        urlpath (str): Youtube url\n        outfile (str, optional): File path/name of output file (.csv)\n        audioformat (str, optional): Audioformat supported in self.__audioextension\n        audiosamplingrate (int, optional): Audio sampling rate\n    '''\n```\n\n#### Youtube -\u003e Audio\n```\ndef url2audio(self, urlpath, audiofile = None, audiosamplingrate=16000):\n    '''\n    Convert youtube url to audiofile\n\n    Parameters:\n        urlpath (str): Youtube url\n        audiofile (str, optional): File path/name to save audio file\n        audiosamplingrate (int, optional): Audio sampling rate\n    '''\n```\n\n#### Audio -\u003e Text\n```\ndef audio2text(self, audiofile, textfile = None):\n    '''\n    Convert audio to csv file\n\n    Parameters:\n        audiofile (str): File path/name of audio file\n        textfile (str, optional): File path/name of text file (*.csv)\n    '''\n```\n## 🚨 Note\n- This repository is highly dependent on [Pytube](https://github.com/pytube/pytube) to download Youtube videos, which at times buggy. Workaround is often provided in issues page of [Pytube repository](https://github.com/pytube/pytube/issues) or [in this repository](https://github.com/codenamewei/youtube2text/issues). Do take the intiative to file for issues to help others who will use this repository.\n\n## 📝 Article \n\nRead out the article below on how to use the repository. \n\n- [Youtube to Text with Speech Recognition in Python](https://towardsdatascience.com/youtube-to-text-with-speech-recognition-in-python-cd47d6d98b16?sk=be41e705c8b182795712a70419a5b8d0)\n\n\n## 📩 Reach out to me  \n\nThis repository is created out from personal use to retrieve audio files for conversational speech recognition and audio classification.\n\nFor custom functionality development support, enterprise support and other related questions, reach out at  \n\u003ca href=\"mailto:codenamewei@gmail.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/-codenamewei@gmail.com-D14836?style=flat\u0026logo=Gmail\u0026logoColor=white\"/\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenamewei%2Fyoutube2text","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodenamewei%2Fyoutube2text","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodenamewei%2Fyoutube2text/lists"}