# Install · OmniGet Docs

- URL: https://getomniget.com/docs/install
- Updated: 2026-10-02
- OmniGet 1.0.0

> Free, open-source yt-dlp GUI for Windows, macOS and Linux. Paste a link to save video, audio and files from 1,000+ sites, or run AI coding agents.

---

Getting started

# Install

OmniGet ships as one installer per system on the [download page](https://getomniget.com/download). Pick the file for your system, check its hash if you want to be sure it is the original, and open it.

## Which file to download

| System | File | Notes |
| --- | --- | --- |
| macOS (macOS 10.15 or later) | `.dmg` | One for Apple Silicon (arm64), one for Intel (x64). |
| Windows (Windows 10 or later) | Setup `.exe` | A normal installer (x64). |
| Linux | `.deb` | Debian, Ubuntu and their family (x64). |
| Linux | `.AppImage` | Other distributions (x64). One file, no install. |

The download page suggests the file for your system and shows the SHA-256 of every file.

## How to install

### macOS

1.  Open the `.dmg`.
2.  Drag **omniget** into **Applications**.
3.  Open it from **Applications**.

### Windows

1.  Run the setup `.exe`.
2.  Follow the installer, then open OmniGet from the Start menu.

### Linux

-   `.deb`: install it with your software centre, or run `sudo apt install ./<file>.deb` in the folder where you saved it.

-   `.AppImage`: make it executable and run it:

    ```
    chmod +x <file>.AppImage
    ./<file>.AppImage
    ```

## The first launch warning

OmniGet has no paid code-signing certificate, so each system asks for confirmation the first time. Check the hash (below) if you want to be sure the file is ours.

-   **Windows:** SmartScreen shows a blue box. Click **More info**, then **Run anyway**.

-   **macOS:** if Gatekeeper says the app is damaged or cannot be opened, move OmniGet to **Applications** and run in Terminal:

    ```
    xattr -cr /Applications/omniget.app
    codesign --force --deep --sign - /Applications/omniget.app
    ```

-   **Linux AppImage:** on Debian 12, Ubuntu 24.04 and newer, the AppImage needs `libfuse2`. Run `sudo apt install libfuse2`, or use the `.deb`.

## Check the hash

The [download page](https://getomniget.com/download) shows the SHA-256 of every file. Compare it with the hash of the file you downloaded:

```
# macOS
shasum -a 256 <file>
# Linux
sha256sum <file>
```

```
# Windows (PowerShell)
Get-FileHash <file> -Algorithm SHA256
```

If the two values differ, delete the file and download it again. [Security](https://getomniget.com/security) explains how releases are built and checked.

## After installing

The first time OmniGet opens, a short setup installs the download engine (yt-dlp and FFmpeg) and asks a few questions. See [First launch](https://getomniget.com/docs/onboarding).

When a new version is out, **Settings** shows a banner with the new version number and an **update now** button. The update replaces the app and keeps your settings.

## Portable mode

Portable mode keeps all of OmniGet’s data in a folder next to the program, so you can carry it on a USB stick.

1.  Find the folder that holds the OmniGet program file (`omniget.exe` on Windows).
2.  Create an empty file named `portable.txt` (or `.portable`) in that folder.
3.  Start OmniGet. It creates a `data` folder next to the program and keeps settings, cookies, the database and the download engines there. On the first portable start, it copies your current settings into it.

To check it worked, open **Settings › Advanced › Storage**. It shows **Portable Mode** and the folder in use. When portable mode is off, that line is not shown.

Note

On macOS the WebView still keeps its session data under `~/Library`. Only OmniGet’s own data moves to the portable folder.

## Where OmniGet keeps its data

Without portable mode, OmniGet uses one folder per user:

| System | Folder |
| --- | --- |
| macOS | `~/Library/Application Support/wtf.tonho.omniget` |
| Windows | `%APPDATA%\wtf.tonho.omniget` |
| Linux | `~/.local/share/wtf.tonho.omniget` |

## Common problems

### Linux: an empty window when a player opens

WebKitGTK plays media through GStreamer. Most desktops have the plugins; minimal installs may not:

```
sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-libav
```

### The antivirus removes or blocks a file

Some antivirus tools flag new apps that have no paid signature. Check the hash first. If it matches, add an exception for OmniGet. See [Troubleshooting](https://getomniget.com/docs/troubleshooting).

### “yt-dlp is missing, so downloads cannot start”

The setup was skipped or the engine install failed. Click **Open Settings** in the banner and install it from **Settings › Advanced › Dependencies**. See [Dependencies](https://getomniget.com/docs/dependencies).

[Previous**← Introduction**](https://getomniget.com/docs/intro) [Next**First launch →**](https://getomniget.com/docs/onboarding)