English · Português (Brasil) · Русский · 简体中文
A local MCP server that lets Claude Code, Codex, Cursor or Gemini CLI download, convert, read your chats and feeds, and tidy your computer.
Also a downloader for video, music and the courses you bought. Free, open source, and everything stays on your machine.
Follow @tonhowtf on Instagram for OmniGet news and inside news.
Connect · Tools · Courses · Manual setup · Safety · Canvas · Downloader · Install · FAQ
1. Open OmniGet.
2. Paste this line into Claude Code, Codex, Gemini CLI, Cursor or any agent that can run a command:
Connect to OmniGet: run curl -s "http://127.0.0.1:47720/connect" and follow the steps.
3. OmniGet comes to the front with the tool's name and a short code. Check the code and click Allow.
OmniGet writes its server and a private token into that tool's own config. Restart the tool and the OmniGet tools are there. Prefer buttons? Settings → AI & agents → Connect to other apps does the same with one click per tool.
Only on Claude Code? The plugin takes three commands and fetches and transcribes links without the desktop app. The last one installs yt-dlp and FFmpeg if they are missing:
/plugin marketplace add tonhowtf/omniget
/plugin install omniget@omniget
/omniget:setup
Then just ask:
Download this playlist as audio and tell me when every file is done: <url>
Here are 12 links. Queue them, wait, and tell me which failed and why.
Turn this folder into one file I can paste into a prompt, under 50k tokens.
What is using port 3000? Stop it.
Read today's messages in my study group chat and list what I still have to answer.
Download every lesson of this course in order and tell me which ones were skipped: <url>
| Downloads | Queue one link or twenty, list formats, wait, pause, retry, read the diagnosis when one fails |
| Whole sites and courses | Drive the built-in browser, read a page within a token budget, download a course in order, write a connector for a new site |
| Files and media | Convert, read finished files, search your book library |
| Developer tools | Folder to one prompt-ready file, page to clean Markdown, a site crawled into files, a pool of rotating proxies, HTTP requests, ports, JSON, JWT, hashes, regex, FTP and SFTP |
| Chats and feeds | Read and reply in your linked chats and social feeds, with your own session |
| Agents | List workspaces, start and follow jobs, read diffs, see pending approvals, drive the Canvas |
| Memory | Recall and teach what the app remembers between sessions |
| Your computer | Scan for junk and plan a cleanup; running it waits for your click |
Results come back as structured data, long ones are cut to a limit and saved to a file, and every error says what to do next.
OmniGet started as a way to keep the courses people had paid for, and it still does that.
- Courses you bought. Open the course in the built-in browser, sign in with your own account and tick the lessons. They come down in order, with their subtitles and documents. Run it again later and only what is missing is downloaded.
- Watch them offline. Video Player turns the folder into a course: subfolders become modules, PDFs and code stay attached to their lesson, and it remembers the lesson you stopped on.
- Or ask your agent. The same downloader is a set of MCP tools, so
download this course in orderis one sentence. - Your files, your disk. Everything lands in a folder you choose, in formats any player opens. No account, no cloud copy, nothing to renew.
- Your own session. OmniGet opens only what your login already opens. Lessons with copy protection stay in the list, marked Protected, and are skipped.
Step by step in the Global Downloader guide.
The server speaks MCP over HTTP at http://127.0.0.1:47720/mcp. Create a connection in Settings → AI & agents → Connect to other apps → More options to get a token and a ready-made snippet for your tool.
Claude Code
read -rs OMNIGET_MCP_TOKEN && export OMNIGET_MCP_TOKEN
claude mcp add --transport http --scope project omniget http://127.0.0.1:47720/mcp \
--header 'Authorization: Bearer ${OMNIGET_MCP_TOKEN}'Cursor (.cursor/mcp.json)
{
"mcpServers": {
"omniget": {
"url": "http://127.0.0.1:47720/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}VS Code (.vscode/mcp.json)
{
"servers": {
"omniget": {
"type": "http",
"url": "http://127.0.0.1:47720/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" }
}
}
}Codex (~/.codex/config.toml)
[mcp_servers.omniget]
url = "http://127.0.0.1:47720/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }Claude Desktop and other stdio-only clients
omniget-mcp ships with every release and bridges stdio to the running app.
{
"mcpServers": {
"omniget": {
"command": "omniget-mcp",
"env": {
"OMNIGET_MCP_URL": "http://127.0.0.1:47720/mcp",
"OMNIGET_MCP_TOKEN": "YOUR_TOKEN"
}
}
}
}It does not connect
APP_NOT_RUNNING: open OmniGet and keep the server on in Settings → AI & agents.UNAUTHORIZEDor 401: the token is missing or was revoked. Create a connection again and paste the new snippet.- A tool is missing: the connection does not have that permission. Tick it under More options.
- Port in use: OmniGet tries 47720 to 47729; the settings page shows the one in use.
- Local only. The server listens on
127.0.0.1and refuses requests from web pages. - A token per tool. Each connection has its own token and only the permissions you tick. Revoke one without touching the others.
- Your click, not the agent's. New connections, cleanups and anything written to your Telegram account wait for you in the OmniGet window. Other messages and posts on your accounts wait too when Ask me first is on; it is off by default. An agent can never approve its own request.
- Secrets stay put. Cookies, tokens and keys are never returned to an agent.
- No account, no telemetry about what you download. OmniGet goes online for the sites you ask for, for updates, and for the model provider you configured.
A board where Claude Code, Codex, Gemini CLI, OpenCode or a local model run side by side in terminals. Draw a cord and two agents can talk. Turn on Lead Mode and one agent recruits and coordinates the others. Usage limits for each account sit on the edge of the screen.
Paste a link, pick a quality, press Enter.
| Video and audio | Own extractors for YouTube, Instagram, TikTok, X, Reddit, Bilibili, Twitch, Vimeo and more, plus every site yt-dlp supports. Up to 4K, or audio as M4A, MP3, Opus, FLAC, WAV |
| Galleries | Whole galleries and profiles through gallery-dl |
| Files | Magnet links and .torrent, direct links in parallel chunks, HLS streams, live recordings |
| Telegram | Messages, albums, ranges and whole chats with your own account |
| The queue | Resume, retry with backoff, rules per site, followed channels, survives a restart |
| Browser extension | Chrome, Edge, Brave and Firefox: send a page or its media to OmniGet with your login |
yt-dlp, FFmpeg, aria2 and gallery-dl install and update themselves. No Python, no PATH, no terminal.
| Media | Music · Video Player · Tube Player · Read · Photos |
| Download | Built-in Browser · Telegram |
| Create | Converter · PDF · Remove Background · Capture · Studio · Dictation |
| Design | Palette · Fonts · Icons · Motion · Board · Components |
| Social | Phone Chats · Server Chats · Short Posts · Photo Feed · Clip Feed · Forums · Pin Boards · Code Hub · Research |
| Developer | DevTools · Repo to Prompt · Scrape · API |
| System | Transfer · System Cleaner |
System Cleaner scans, shows a plan, and runs only after you approve. Files go to a quarantine or the Trash, and History undoes it.
Loop sits in your menu bar or tray. One click on the icon opens a small panel: keep the computer awake, clipboard history, saved snippets, a live system monitor, volume per app, and shortcuts to capture, dictation and the cleaner. On Windows, macOS and Linux; each system shows only what works there. With the panel closed, only what you turned on keeps running.
Download from getomniget.com. The page lists the SHA-256 of every file. Updates arrive inside the app.
| Windows 10 and 11 | Installer .exe, portable .exe, .msi |
| macOS 10.15+ | .dmg for Apple Silicon and Intel |
| Linux | .deb, .rpm, .AppImage for x86_64 |
On macOS you can also install with Homebrew: brew tap tonhowtf/tap, then brew install --cask omniget.
First launch warnings and antivirus
OmniGet ships without a paid code-signing certificate, so each system asks once.
-
Windows: SmartScreen shows a blue box. Click More info, then Run anyway.
-
macOS: if Gatekeeper says the app is "damaged", move it to Applications and run:
xattr -cr /Applications/omniget.app codesign --force --deep --sign - /Applications/omniget.app
-
Linux AppImage: on a libfuse error, run
sudo apt install libfuse2or use the.deb. -
Antivirus: a few engines flag new unsigned builds by mistake. Compare the file's SHA-256 with
SHA256SUMS, then report the false positive to the vendor. Do not turn your antivirus off.
Command line
omniget-cli and omniget-mcp come with every release. Add --json for machine-readable output.
omniget-cli info <url> # title, formats and size
omniget-cli download <url> -q 1080 -o ~/Videos
omniget-cli batch links.txt -m 3 # one URL per line, 3 at a time
omniget-cli convert notes.md --to html
omniget-cli usage --watch 60 # usage limits per accountThe claude-plugin/ folder is a Claude Code plugin that fetches and transcribes media from a link, with or without the desktop app.
Build from source
You need Rust (pinned in rust-toolchain.toml), Node.js (see .nvmrc) and pnpm.
pnpm install
pnpm tauri devpnpm tauri dev uses its own profile, so it never touches an installed OmniGet. pnpm dev:web opens the interface in a browser with no Rust build. Read CONTRIBUTING.md before sending code.
A free, open source desktop app for Windows, macOS and Linux. Its main part is a local MCP server that gives your coding agent a toolbox for downloads, media, files, your chats and your computer. It is also a downloader on its own: paste a link, get the file, or keep an offline copy of a course you bought.
Yes. It is licensed under GPL-3.0, needs no account and has no telemetry about what you download.
Claude Code, Codex, Gemini CLI, Cursor and VS Code connect to the MCP server over HTTP. Claude Desktop and other stdio-only clients use the omniget-mcp adapter that ships with every release. See Connect in one minute.
Only inside the permissions you ticked for that connection. The server listens on 127.0.0.1 only and each connection has its own token. A new connection, a cleanup and anything written to your Telegram account always wait for your click in the OmniGet window. Other messages and posts on your accounts wait too when Ask me first is on in the connection settings; it is off by default, so turn it on if you grant those permissions. An agent can never approve its own request. See You stay in control.
No. OmniGet installs and updates yt-dlp, FFmpeg and gallery-dl by itself, and checks the hash of each tool before using it.
YouTube, Instagram, TikTok, X, Reddit, Bilibili, Twitch and Vimeo have their own extractors, and every site yt-dlp supports works too. It also takes galleries through gallery-dl, magnet links and .torrent files, and direct links.
Yes, the ones your own account can open. Open the course in the built-in browser, sign in and pick the lessons; lessons with copy protection are marked Protected and skipped. See Keep what is yours.
No. It downloads what your own session can already open. See Fair use.
Each system asks once about an app it has not seen before. Install says what to click, and the download page lists the SHA-256 of every file so you can check yours.
This repository, tonhowtf/omniget, and getomniget.com. Forks are legal under GPL-3.0 and some use similar names; getomniget.com/forks tells them apart.
Read CONTRIBUTING.md and ARCHITECTURE.md, pick a good first issue, or translate the interface in your browser.
More answers in the docs FAQ.
OmniGet downloads what your own session can already open. It does not bypass DRM, break paywalls or share credentials. It is meant for personal copies and content you have the right to keep; you are responsible for copyright and each platform's terms. Platform owners: see PLATFORM-OWNERS.md.
Contributing guide · Architecture · Governance · Get help · Security policy
Report a problem · Translate · Community · Media kit
Free code signing provided by SignPath.io, certificate by SignPath Foundation.
- Authors and approvers: Antonio Leandro. Every release is approved by hand before it is signed.
- Reviewers: pull requests from contributors are reviewed by the author before they are merged.
- Signed binaries are built by GitHub Actions from this repository only.
- Privacy: see the privacy policy. OmniGet sends nothing to other systems unless you ask it to.
Built on yt-dlp, FFmpeg, gallery-dl, aria2, librqbit, grammers, whisper.cpp, Tauri and Svelte. Full list with licenses in THIRD_PARTY.md.
Loop is OmniGet's mascot. Fan art is welcome; the original artwork may not be used commercially or redistributed modified.
Download OmniGet · getomniget.com · GPL-3.0 · Made by Antonio Leandro












