Skip to content
Back to search

Snag

Native macOS YouTube downloader: best quality (4K, HDR, AV1), original audio, subtitles and thumbnails. Built on yt-dlp, with an MCP server for Claude.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nurik-dz--snag/badge.svg)](/listings/nurik-dz--snag)

HTML

<a href="/listings/nurik-dz--snag"><img src="/api/listings/nurik-dz--snag/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install --cask nurik-dz/tap/snag

Homebrew also installs the download engine Snag drives: [yt-dlp](https://github.com/yt-dlp/yt-dlp), [ffmpeg](https://ffmpeg.org) and [deno](https://deno.com).

To install by hand instead: `brew install yt-dlp ffmpeg deno`, then download `Snag.zip` from [Releases](https://github.com/Nurik-dz/Snag/releases/latest), unzip it and move **Snag.app** to Applications. Snag is not notarized; if macOS blocks it, open **System Settings → Privacy & Security** and choose **Open Anyway**, or run:

xattr -dr com.apple.quarantine /Applications/Snag.app

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 119 lines
  1. <p align="center">
  2. <img src="docs/icon.png" width="128" alt="Snag icon">
  3. </p>
  4. <h1 align="center">Snag</h1>
  5. <p align="center">
  6. A native YouTube downloader for macOS that always grabs the best quality there is:<br>
  7. 4K, HDR and AV1 video, original audio, subtitles, thumbnail and description, signed in through your own browser.
  8. </p>
  9. <p align="center">
  10. <img alt="macOS 26+" src="https://img.shields.io/badge/macOS-26%2B-black?logo=apple">
  11. <img alt="Apple silicon" src="https://img.shields.io/badge/Apple%20silicon-arm64-black">
  12. <img alt="Swift" src="https://img.shields.io/badge/Swift-SwiftUI-F05138?logo=swift&logoColor=white">
  13. <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue">
  14. </p>
  15. <p align="center">
  16. <img src="docs/screenshot.png" width="440" alt="Snag with a video ready to download">
  17. </p>
  18. ---
  19. ## Install
  20. ```sh
  21. brew install --cask nurik-dz/tap/snag
  22. ```
  23. Homebrew also installs the download engine Snag drives: [yt-dlp](https://github.com/yt-dlp/yt-dlp),
  24. [ffmpeg](https://ffmpeg.org) and [deno](https://deno.com).
  25. To install by hand instead: `brew install yt-dlp ffmpeg deno`, then download `Snag.zip` from
  26. [Releases](https://github.com/Nurik-dz/Snag/releases/latest), unzip it and move **Snag.app** to Applications.
  27. Snag is not notarized; if macOS blocks it, open **System Settings → Privacy & Security** and choose **Open Anyway**, or run:
  28. ```sh
  29. xattr -dr com.apple.quarantine /Applications/Snag.app
  30. ```
  31. ## Features
  32. - **Paste a link, get the best version.** Videos, Shorts, playlists and whole channels (`@handle`).
  33. - **Plays everywhere.** 4K AV1 and Opus are packed into MP4 files that open in QuickTime. When a video only exists as
  34. VP9, Snag converts it to HEVC with the Mac's hardware encoder at the same resolution (or keeps the VP9, your choice).
  35. - **Audio**: original (Opus copied untouched into `.m4a`), AAC 256 kbps, MP3 320 kbps, FLAC or WAV.
  36. - **Subtitles**: SRT, VTT or both. YouTube's rolling auto-captions are cleaned up to one line each.
  37. - **Thumbnail** at full 1280×720 (no re-encoding) and the **description** as a text file.
  38. - **Signed in through your browser**: Brave, Chrome, Edge, Firefox, Vivaldi, Opera, Chromium or Safari, so videos that
  39. need your account (age-restricted, members-only) download too.
  40. - Download list with progress in the Dock, notifications when done, pause and resume.
  41. - Appearance: Liquid Glass, Frosted or Solid; light, dark or system.
  42. ## Sign-in and Full Disk Access
  43. To read your browser's sign-in, macOS requires **Full Disk Access** for Snag
  44. (System Settings → Privacy & Security → Full Disk Access). Without it, public videos still work and the window shows
  45. **Not signed in yet**. Chromium-based browsers ask once for your login password to unlock their cookie store
  46. (choose **Always Allow**).
  47. ## Use Snag from Claude
  48. Snag ships with `snag-mcp`, a small [MCP](https://modelcontextprotocol.io) server inside the app. In
  49. **Settings → Claude**, click **Connect** to register it with Claude Code and the Claude desktop app. Claude can then:
  50. | Tool | What it does |
  51. | --- | --- |
  52. | `snag_lookup` | Title, channel, length and every available quality for a video, Short, playlist or channel |
  53. | `snag_download` | Queues a download in the running Snag app (it appears in the Downloads list) |
  54. | `snag_status` | Progress of current and recent downloads |
  55. | `snag_transcript` | A video's transcript as plain text |
  56. Try: *"use Snag to download this video in 4K"*.
  57. To connect by hand: `claude mcp add snag -s user -- /Applications/Snag.app/Contents/MacOS/snag-mcp`
  58. ## Build from source
  59. Requires macOS 26 or later, the Xcode Command Line Tools (`xcode-select --install`) and `brew install yt-dlp ffmpeg deno`.
  60. ```sh
  61. git clone https://github.com/Nurik-dz/Snag.git
  62. cd Snag
  63. ./build.sh # builds Snag.app (app + snag-mcp helper) in this folder
  64. open Snag.app
  65. ```
  66. ## Tests
  67. ```sh
  68. Tests/run.sh engine <link> <output-folder> [video,audio,subs,thumb,desc] [max-height]
  69. ```
  70. Looks up a real video and downloads it with the chosen parts into the output folder.
  71. ## Project layout
  72. ```
  73. Sources/
  74. App/ app entry point
  75. Engine/ yt-dlp / ffmpeg driver, format choice, subtitles, tool discovery
  76. Model/ settings and download records
  77. State/ app model and download queue
  78. System/ Dock progress, notifications
  79. Views/ SwiftUI screens
  80. MCP/ snag-mcp, the MCP server (stdio)
  81. Tests/ engine test
  82. tools/ icon generator
  83. ```
  84. ## Good to know
  85. - YouTube occasionally answers an unsigned request with HTTP 403; Snag looks the video up again and retries once.
  86. - Keep the engine fresh with `brew upgrade yt-dlp` when YouTube changes something.
  87. ## License
  88. [MIT](LICENSE) © 2026 Nurik-dz. Snag drives yt-dlp, ffmpeg and deno, which are installed separately under their own licenses.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.