tonhowtf/omniget

Public

Local MCP server that lets Claude Code, Codex, Cursor and Gemini CLI use your own computer and your own logged-in accounts: chats, feeds, browser, files and downloads. Also a downloader for video, music and the courses you bought. Everything stays on your machine. Windows, macOS, Linux.

  • Stars14.5k+148 tuần này
  • Forks1.3k
  • Watchers47
  • Issues14
  • Ngày tạo12/02/2026
  • Cập nhật gần nhất21/11/2026
  • Ngôn ngữRust
  • Giấy phépGPL-3.0
README.md40.9 KBRaw

OmniGet

English · Português (Brasil) · Русский · 简体中文

Loop, the OmniGet mascot, rides an orange plug like a rocket while its cables reach three terminal windows

Your coding agent, on your own computer and your own accounts.

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.

Download OmniGet for Windows, macOS or Linux

getomniget.com License GPL-3.0 Community chat Follow @tonhowtf on Instagram Translation status OpenSSF Scorecard

Follow @tonhowtf on Instagram for OmniGet news and inside news.

Connect · Tools · Courses · Manual setup · Safety · Canvas · Downloader · Install · FAQ


Connect in one minute

Loop slams a green button with a check mark; a locked cable links it to a terminal

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.

The Connect to other apps section in Settings, with one button that creates an access and copies the prompt

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>

An agent asks OmniGet for two films from the Internet Archive; the Downloads screen shows each one go from queued to complete


What your agent can do

Loop opens a red toolbox and a wrench, film, music note, magnifier, broom, camera and microphone fly out toward a terminal

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.


Keep what is yours

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 order is 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.


Configure it by hand

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.
  • UNAUTHORIZED or 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.

You stay in control

Loop sits on a closed laptop holding a key, in front of a shield with a padlock

  • Local only. The server listens on 127.0.0.1 and 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.

The Canvas

Loop holds four colored cords that reach four terminal windows around it

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.


The downloader

A chain link breaks and a clapperboard, a music note, a photo and books fly toward Loop, who catches them

Paste a link, pick a quality, press Enter.

The Home screen with the link bar

The Downloads page with two downloads in progress showing phase, speed and time left

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.


Tools

The Tools page with cards grouped by Media and Download

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

The System Cleaner showing the junk found, by category

System Cleaner scans, shows a plan, and runs only after you approve. Files go to a quarantine or the Trash, and History undoes it.


Quick tools

The Quick tools panel with shortcuts and keep awake

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.


Install

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 libfuse2 or 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 account

The 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 dev

pnpm 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.


FAQ

What is OmniGet?

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.

Is OmniGet free?

Yes. It is licensed under GPL-3.0, needs no account and has no telemetry about what you download.

Which AI agents work with OmniGet?

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.

Can an agent act on my computer without asking me?

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.

Do I need to install yt-dlp, FFmpeg or Python?

No. OmniGet installs and updates yt-dlp, FFmpeg and gallery-dl by itself, and checks the hash of each tool before using it.

Which sites can OmniGet download from?

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.

Does OmniGet download online courses?

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.

Does OmniGet bypass DRM or paywalls?

No. It downloads what your own session can already open. See Fair use.

Why does Windows or macOS show a warning on first launch?

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.

Which OmniGet is the original?

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.

How can I help?

Read CONTRIBUTING.md and ARCHITECTURE.md, pick a good first issue, or translate the interface in your browser.

More answers in the docs FAQ.

Fair use

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

Contributing guide · Architecture · Governance · Get help · Security policy

Report a problem · Translate · Community · Media kit

Code signing policy

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.

Credits

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

Nội dung README thuộc về tonhowtf và cộng đồng đóng góp, giấy phép GPL-3.0. Nguồn: github.com/tonhowtf/omniget