{"id":49030246,"url":"https://github.com/whoisjayd/notewise","last_synced_at":"2026-05-01T09:06:55.142Z","repository":{"id":334688749,"uuid":"1142278959","full_name":"whoisjayd/notewise","owner":"whoisjayd","description":"CLI tool to generate deep study notes from YouTube. Features chapter detection, smart chunking for long videos, and multi-language support.","archived":false,"fork":false,"pushed_at":"2026-04-14T16:55:53.000Z","size":5516,"stargazers_count":5,"open_issues_count":8,"forks_count":7,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-14T18:28:40.414Z","etag":null,"topics":["ai","cli","education","gemini","llm","notes-generator","productivity","python","study-assist","transcript","youtube-dl"],"latest_commit_sha":null,"homepage":"http://docs.notewise.click/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/whoisjayd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-26T07:39:08.000Z","updated_at":"2026-04-14T16:55:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/whoisjayd/notewise","commit_stats":null,"previous_names":["whoisjayd/yt-study","whoisjayd/notewise"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/whoisjayd/notewise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoisjayd%2Fnotewise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoisjayd%2Fnotewise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoisjayd%2Fnotewise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoisjayd%2Fnotewise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/whoisjayd","download_url":"https://codeload.github.com/whoisjayd/notewise/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/whoisjayd%2Fnotewise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32000740,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T20:23:30.271Z","status":"online","status_checked_at":"2026-04-19T02:00:07.110Z","response_time":55,"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":["ai","cli","education","gemini","llm","notes-generator","productivity","python","study-assist","transcript","youtube-dl"],"created_at":"2026-04-19T09:02:40.712Z","updated_at":"2026-05-01T09:06:55.131Z","avatar_url":"https://github.com/whoisjayd.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🎓 NoteWise\n\n**Convert YouTube videos and playlists into local study notes from your terminal.**\n\n\u003cbr /\u003e\n\n\u003cimg src=\"https://img.shields.io/pypi/v/notewise?style=flat-square\u0026label=version\" alt=\"version\" /\u003e \u003cimg src=\"https://img.shields.io/badge/status-beta-f59e0b?style=flat-square\" alt=\"status\" /\u003e \u003cimg src=\"https://img.shields.io/badge/license-MIT--Attribution-10b981?style=flat-square\" alt=\"license\" /\u003e \u003cimg src=\"https://img.shields.io/badge/python-3.10%20|%203.11%20|%203.12%20|%203.13-3776AB?style=flat-square\u0026logo=python\u0026logoColor=white\" alt=\"python versions\" /\u003e \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/whoisjayd/notewise/ci-main.yml?branch=main\u0026style=flat-square\u0026label=CI\u0026logo=github\" alt=\"CI\" /\u003e \u003cimg src=\"https://img.shields.io/badge/LiteLLM-powered-ff6b35?style=flat-square\" alt=\"litellm\" /\u003e\n\n\u003cbr /\u003e\u003cbr /\u003e\n\n[Website](https://notewise.click) · [Docs](https://notewise.click/docs) · [Install](https://notewise.click/install) · [Quickstart](https://notewise.click/docs/start/quickstart) · [Contributing](CONTRIBUTING.md)\n\n\u003c/div\u003e\n\n## 💡 Why NoteWise?\n\nYouTube has become one of the richest learning platforms on the planet — university lectures, conference talks, technical deep-dives, language lessons, and entire courses are all freely available. But video is a passive medium. You watch, you nod, and two days later the details are gone.\n\n**NoteWise was built to fix that gap.**\n\nThe idea is simple: your time watching a video is valuable. The notes that _should_ come from it — the structured, searchable, reviewable kind — should not require an extra hour of your day. NoteWise automates that step. Point it at a YouTube URL and walk away with local Markdown study notes that are deeper and more useful than most people would write by hand.\n\n**Where it shines:**\n\n- 📚 **Students** catching up on lecture recordings or supplementing textbooks with YouTube explanations\n- 🧑‍💻 **Developers** staying on top of conference talks, tutorials, and technical deep-dives without watching at 3x speed\n- 🌍 **Language learners** extracting structured notes from native-language content\n- 📋 **Researchers** quickly distilling hours of talks into organized, searchable reference material\n- 🏢 **Teams** turning internal video presentations into shareable written documentation\n\nThe output is not just a transcript summary. It is structured, hierarchical Markdown with headers, sub-topics, definitions, examples, and concepts explained in depth. Chapter-aware videos can be split into per-chapter files, and long courses can be processed into organized local notes. Everything lands in your filesystem: portable, searchable, and permanently yours.\n\n## Quick start\n\n```bash\nuv tool install notewise\nnotewise setup\nnotewise process \"https://youtu.be/VIDEO_ID\"\n```\n\nGenerated notes land in `./output` by default.\n\nPrefer another install method?\n\n```bash\n# Try without installing\nuvx notewise --help\n\n# Standalone binary installer\ncurl -fsSL https://notewise.click/install | sh\n```\n\nWindows PowerShell:\n\n```powershell\nirm https://notewise.click/install | iex\n```\n\nSee the full [installation guide](https://notewise.click/docs/start/install) for `uv`, `uvx`, `pipx`, `pip`, Docker, and standalone binaries.\n\n## Demo\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"demo/notewise.gif\" alt=\"NoteWise CLI demo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003csub\u003eWatch the full demo: \u003ca href=\"demo/notewise.mp4\"\u003edemo/notewise.mp4\u003c/a\u003e\u003c/sub\u003e\n\u003c/p\u003e\n\n## Documentation\n\n| Need                         | Go here                                                                  |\n| ---------------------------- | ------------------------------------------------------------------------ |\n| Install choices              | [Install NoteWise](https://notewise.click/docs/start/install)            |\n| First successful run         | [Quickstart](https://notewise.click/docs/start/quickstart)               |\n| Processing flags and formats | [Process videos](https://notewise.click/docs/use/process)                |\n| Provider/model setup         | [Providers](https://notewise.click/docs/config/providers)                |\n| OAuth providers              | [OAuth](https://notewise.click/docs/config/oauth)                        |\n| Playlists and batches        | [Playlists \u0026 batches](https://notewise.click/docs/use/playlists-batches) |\n| Troubleshooting              | [Troubleshooting](https://notewise.click/docs/operate/troubleshooting)   |\n| CLI command reference        | [Commands](https://notewise.click/docs/operate/commands)                 |\n\n## Common commands\n\n```bash\nnotewise process \"https://youtu.be/VIDEO_ID\" --format md,docx --quiz\nnotewise process \"https://youtube.com/playlist?list=PLAYLIST_ID\"\nnotewise doctor\nnotewise update\n```\n\n`notewise update` checks the latest release and prints the right upgrade command group for standalone binary or Python package installs. Run `notewise --help` or open the [command reference](https://notewise.click/docs/operate/commands) for the full CLI surface.\n\n## Development\n\n```bash\ngit clone https://github.com/whoisjayd/notewise\ncd notewise\nuv sync --dev\nmake test\n```\n\nWebsite work uses Bun from `website/`:\n\n```bash\nbun install --frozen-lockfile\nbun run lint\nbunx tsc --noEmit\nbun run build\n```\n\nDocs live in `docs/`. Do not run Prettier on Mintlify MDX; validate docs config with:\n\n```bash\npython -m json.tool docs/docs.json\nnode --check docs/umami.js\n```\n\nRead [CONTRIBUTING.md](CONTRIBUTING.md) before opening a PR.\n\n## License\n\n[MIT with Attribution](LICENSE). If you use NoteWise in a project or build on top of it, include credit and a link back to this repository.\n\n## Thanks\n\nNoteWise is built on a great open-source ecosystem. See [GRATITUDE.md](GRATITUDE.md) for acknowledgements.\n\nFound a bug? [Open an issue](https://github.com/whoisjayd/notewise/issues/new/choose). Security concern? See [SECURITY.md](SECURITY.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoisjayd%2Fnotewise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwhoisjayd%2Fnotewise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwhoisjayd%2Fnotewise/lists"}