<h1 align="center">OmniGet</h1>

<p align="center">
  <b>English</b>
  · <a href="README.pt-BR.md">Português (Brasil)</a>
  · <a href="README.ru.md">Русский</a>
  · <a href="README.zh-CN.md">简体中文</a>
</p>

<p align="center">
  <a href="https://getomniget.com"><img src="assets/readme/loop-mcp-hero.gif" alt="Loop, the OmniGet mascot, rides an orange plug like a rocket while its cables reach three terminal windows" width="820" /></a>
</p>

<h3 align="center">An MCP server that gives your coding agent a whole desktop toolbox.</h3>

<p align="center">
  Downloads, media, files, your chats and your computer, behind one local server.<br/>
  Free, open source, and everything runs on your machine.
</p>

<p align="center">
  <a href="https://getomniget.com/download"><img src="https://img.shields.io/badge/Download_for_Windows,_macOS_or_Linux-→-F28500?style=for-the-badge" alt="Download OmniGet for Windows, macOS or Linux" height="40" /></a>
</p>

<p align="center">
  <a href="https://getomniget.com"><img src="https://img.shields.io/badge/website-getomniget.com-F28500?style=flat-square" alt="getomniget.com" /></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-2AA845?style=flat-square" alt="License GPL-3.0" /></a>
  <a href="https://discord.gg/jgdxyPy7Vn"><img src="https://img.shields.io/badge/chat-community-5865F2?style=flat-square" alt="Community chat" /></a>
  <a href="https://www.instagram.com/tonhowtf/"><img src="https://img.shields.io/badge/Instagram-@tonhowtf-E4405F?style=flat-square&logo=instagram&logoColor=white" alt="Follow @tonhowtf on Instagram" /></a>
  <a href="https://hosted.weblate.org/engage/omniget/"><img src="https://hosted.weblate.org/widget/omniget/frontend-json/svg-badge.svg" alt="Translation status" /></a>
</p>

<p align="center">
  Follow <a href="https://www.instagram.com/tonhowtf/">@tonhowtf on Instagram</a> for OmniGet news and inside news.
</p>

<p align="center">
  <a href="#connect-in-one-minute">Connect</a> · <a href="#what-your-agent-can-do">Tools</a> · <a href="#configure-it-by-hand">Manual setup</a> · <a href="#you-stay-in-control">Safety</a> · <a href="#the-canvas">Canvas</a> · <a href="#the-downloader">Downloader</a> · <a href="#install">Install</a>
</p>

---

## Connect in one minute

<p align="center">
  <img src="assets/readme/loop-connect.webp" alt="Loop slams a green button with a check mark; a locked cable links it to a terminal" width="820" />
</p>

**1.** Open OmniGet.

**2.** Paste this line into Claude Code, Codex, Gemini CLI, Cursor or any agent that can run a command:

```text
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.

<p align="center">
  <img src="assets/readme/mcp-connect.webp" alt="The Connect to other apps section in Settings, with one button that creates an access and copies the prompt" width="860" />
</p>

Then just ask:

```text
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.
```

---

## What your agent can do

<p align="center">
  <img src="assets/readme/loop-tools.webp" alt="Loop opens a red toolbox and a wrench, film, music note, magnifier, broom, camera and microphone fly out toward a terminal" width="820" />
</p>

| | |
|---|---|
| **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, 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.

---

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

<details>
<summary><b>Claude Code</b></summary>

```bash
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}'
```

</details>

<details>
<summary><b>Cursor</b> (<code>.cursor/mcp.json</code>)</summary>

```json
{
  "mcpServers": {
    "omniget": {
      "url": "http://127.0.0.1:47720/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
```

</details>

<details>
<summary><b>VS Code</b> (<code>.vscode/mcp.json</code>)</summary>

```json
{
  "servers": {
    "omniget": {
      "type": "http",
      "url": "http://127.0.0.1:47720/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
```

</details>

<details>
<summary><b>Codex</b> (<code>~/.codex/config.toml</code>)</summary>

```toml
[mcp_servers.omniget]
url = "http://127.0.0.1:47720/mcp"
http_headers = { Authorization = "Bearer YOUR_TOKEN" }
```

</details>

<details>
<summary><b>Claude Desktop and other stdio-only clients</b></summary>

`omniget-mcp` ships with every release and bridges stdio to the running app.

```json
{
  "mcpServers": {
    "omniget": {
      "command": "omniget-mcp",
      "env": {
        "OMNIGET_MCP_URL": "http://127.0.0.1:47720/mcp",
        "OMNIGET_MCP_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}
```

</details>

<details>
<summary><b>It does not connect</b></summary>

- **`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.

</details>

---

## You stay in control

<p align="center">
  <img src="assets/readme/loop-privacy.webp" alt="Loop sits on a closed laptop holding a key, in front of a shield with a padlock" width="820" />
</p>

- **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 that posts or sends wait for you in the OmniGet window. 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

<p align="center">
  <img src="assets/readme/loop-canvas.webp" alt="Loop holds four colored cords that reach four terminal windows around it" width="820" />
</p>

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

<p align="center">
  <img src="assets/readme/loop-downloader.webp" alt="A chain link breaks and a clapperboard, a music note, a photo and books fly toward Loop, who catches them" width="820" />
</p>

Paste a link, pick a quality, press Enter.

<p align="center">
  <img src="assets/readme/home.webp" alt="The Home screen with the link bar" width="860" />
</p>

<p align="center">
  <img src="assets/readme/downloads.webp" alt="The Downloads page with two downloads in progress showing phase, speed and time left" width="860" />
</p>

| | |
|---|---|
| **Video and audio** | Own extractors for YouTube, Instagram, TikTok, X, Reddit, Bilibili, Twitch, Vimeo and more, plus every site [yt-dlp](https://github.com/yt-dlp/yt-dlp) supports. Up to 4K, or audio as M4A, MP3, Opus, FLAC, WAV |
| **Galleries** | Whole galleries and profiles through [gallery-dl](https://github.com/mikf/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

<p align="center">
  <img src="assets/readme/tools-hub.webp" alt="The Tools page with cards grouped by Media and Download" width="860" />
</p>

| | |
|---|---|
| **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 |

<p align="center">
  <img src="assets/readme/cleaner.webp" alt="The System Cleaner showing the junk found, by category" width="860" />
</p>

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

<p align="center">
  <img src="assets/readme/quick-tools.webp" alt="The Quick tools panel with shortcuts and keep awake" width="380" />
</p>

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](https://getomniget.com/download)**. 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 and ARM64 |

<details>
<summary>First launch warnings and antivirus</summary>

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:

  ```bash
  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.

</details>

<details>
<summary>Command line</summary>

`omniget-cli` and `omniget-mcp` come with every release. Add `--json` for machine-readable output.

```bash
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/`](claude-plugin/omniget) folder is a Claude Code plugin that fetches and transcribes media from a link, with or without the desktop app.

</details>

<details>
<summary>Build from source</summary>

You need [Rust](https://rustup.rs/) (pinned in `rust-toolchain.toml`), [Node.js](https://nodejs.org/) (see `.nvmrc`) and [pnpm](https://pnpm.io/).

```bash
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](CONTRIBUTING.md) before sending code.

</details>

---

## 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](PLATFORM-OWNERS.md).

## Contributing

[Report a problem](https://getomniget.com/contact) · [Translate](https://hosted.weblate.org/engage/omniget/) · [Community](https://getomniget.com/community) · [Media kit](MEDIA-KIT.md)

## Code signing policy

Free code signing provided by [SignPath.io](https://about.signpath.io/), certificate by [SignPath Foundation](https://signpath.org/).

- Authors and approvers: [Antonio Leandro](https://github.com/tonhowtf). 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](https://getomniget.com/privacy). OmniGet sends nothing to other systems unless you ask it to.

## Credits

Built on [yt-dlp](https://github.com/yt-dlp/yt-dlp), [FFmpeg](https://ffmpeg.org/), [gallery-dl](https://github.com/mikf/gallery-dl), [aria2](https://aria2.github.io/), [librqbit](https://github.com/ikatson/rqbit), [grammers](https://github.com/Lonami/grammers), [whisper.cpp](https://github.com/ggml-org/whisper.cpp), [Tauri](https://tauri.app) and [Svelte](https://svelte.dev). Full list with licenses in [THIRD_PARTY.md](THIRD_PARTY.md).

Loop is OmniGet's mascot. Fan art is welcome; the original artwork may not be used commercially or redistributed modified.

<p align="center">
  <a href="https://getomniget.com/download"><b>Download OmniGet</b></a> · <a href="https://getomniget.com">getomniget.com</a> · <a href="LICENSE">GPL-3.0</a> · Made by <a href="https://tonho.wtf/en/projetos/omniget">Antonio Leandro</a>
</p>