Skip to content
Projects

neosy/elengrab has 56 GitHub stars and 3 forks. GitHot measured 0 stars in 24 hours and +2 in 7 days. Last checked 2026-11-18 04:05 UTC. Last push 2026-11-09.

How these counts are measured

What you can do

  • Support for downloading video and audio from 1,000+ websites, powered by yt-dlp extractors.
  • Configurable format and quality settings.
  • Cookie-based authentication support for YouTube and other supported websites.
  • Manual upload of audio and video files.

Measured star growth

in 24h
0
in 7 days
+2
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Fast cross-platform video and audio downloader and media viewer with flexible format and quality options. Supports 1,000+ websites including YouTube, Instagram, TikTok, Twitch, Facebook, Reddit, and more, with self-hosted deployment support.

Self-hosted

README.md

Original

android-chrome-192x192_round

Self-hosted cross-platform downloader and media viewer for video and audio from 1,000+ platforms (YouTube, Instagram, TikTok, Twitch, etc.).


elengrab_interface

Elengrab

Fast cross-platform application for downloading and watching video and audio with flexible format and quality options. Integrates with media processing utilities such as yt-dlp and ffmpeg. Supports downloading from more than 1,000 websites and platforms, including YouTube, Facebook, Instagram, Twitter/X, Twitch, Pinterest, Reddit, VK Video, Rutube, and more.

Elengrab provides a simple and very fast web interface for downloading and watching media directly in the browser, with a YouTube-like viewing experience, thumbnails, video previews, and a dedicated interface optimized for mobile devices. Supports Grid View, short links for sharing, and flexible playback options. On mobile devices, videos can be shared directly from apps such as YouTube and Instagram to Elengrab, where they are automatically picked up and downloaded.

The project is fully written in Go, with a frontend built using plain HTML and CSS, HTMX, and vanilla JavaScript without external libraries. It can run as a single binary on Windows, Linux, and macOS, or in a lightweight Docker container for easy deployment. Elengrab also includes full PWA support, allowing it to be installed and used as a standalone application. Different operating modes allow you to enable authentication and use Elengrab as a full-featured web service accessible over the Internet. This makes it well suited for creating a fast-access home media service as well as a personal media service accessible from anywhere.

Download for Windows Download for Linux Download for MacOS Silicon Download for MacOS Intel

For all other downloads, see the latest release.

Screenshots of the interface

Desktop — Light and dark themes   

Screenshot_160    Screenshot_158

Desktop — Grid view   

image    image

Desktop — Menu and Editing   

image     image

Mobile — Light and dark themes   

image     image

   

image     image

Mobile — Menu and Editing   

image     image

Features

  • Support for downloading video and audio from 1,000+ websites, powered by yt-dlp extractors.
  • Configurable format and quality settings.
  • Cookie-based authentication support for YouTube and other supported websites.
  • Manual upload of audio and video files.
  • Task queue for media processing.
  • Concurrent processing of multiple tasks.
  • Instant addition and removal of tasks from the queue.
  • Built-in media search by title and description.
  • Media sorting by Newest, Popular, and Oldest.
  • In-browser video and audio playback.
  • Video thumbnails and media type indicators.
  • Video preview on desktop and mobile devices.
  • Watch progress tracking with resume playback and view statistics.
  • Grid View and list view for browsing media.
  • Short links for sharing media.
  • Mobile sharing support for importing videos directly from apps such as YouTube and Instagram.
  • PWA support for installing Elengrab as a standalone application.
  • Multiple access modes for anonymous, read-only, session-isolated, and authenticated access.
  • Configurable media visibility and public access.
  • Animated status indicators for download and processing tasks.
  • Real-time task and media updates via SSE.
  • Channel and website icons displayed in the interface.
  • Responsive interface optimized for desktop and mobile devices.
  • Dark theme.
  • Cross-platform support: Windows, macOS, and Linux.
  • Docker support for easy deployment.

Media Content

Elengrab is designed to work with video and audio content from a wide range of websites and platforms through yt-dlp.

Users are responsible for ensuring that their use of Elengrab and downloaded content complies with applicable laws, copyright requirements, and the terms of service of the respective platforms.

Requirements

Minimum

  • CPU: 1–2 cores
  • Memory: ~512 MB RAM
  • Concurrent downloads: 1 worker
  • Dependencies: yt-dlp and ffmpeg must be installed
  • Optional: Deno is required when using cookie support

This configuration is suitable for low-resource servers. To limit concurrency, set:

ELENGRAB_DOWNLOAD_WORKERS=1

Recommended

  • CPU: 4 cores
  • Memory: 4 GB RAM
  • Concurrent downloads: 3 workers (default)
  • Dependencies: yt-dlp and ffmpeg must be installed
  • Optional: Deno is required when using cookie support

By default, the Docker container is configured to use this setup.

Notes

The main resource consumers are yt-dlp and ffmpeg, especially during video downloading, merging, and transcoding.

Resource usage increases with the number of concurrent workers. The number of concurrent workers can be adjusted using the following environment variable:

ELENGRAB_DOWNLOAD_WORKERS=3

Quick Start

Run docker with minimum settings

docker run -d \
  --name elengrab \
  -v elengrab_downloads:/app_n/downloads \
  -p 8080:8080 \
  neosy/elengrab:latest

Environment Variables

Variable Default Description
ELENGRAB_LOG_LEVEL warn Logging level. Options: debug, info, warn, error.
ELENGRAB_SQLITE_DATA_DIR sqlite/data Directory where SQLite database files are stored.
ELENGRAB_SQLITE_BACKUPS_DIR sqlite/backups Directory where SQLite backup files are stored.
ELENGRAB_ROOT_DIR (not set) Application base directory. If empty, defaults to: ~/.elengrab on Linux/macOS, %LOCALAPPDATA%\Elengrab on Windows.
ELENGRAB_DOWNLOADER_BIN_DIR /usr/local/bin Directory containing yt-dlp binary.
ELENGRAB_ASSETS_DIR assets Directory containing application assets.
ELENGRAB_DOWNLOADS_DIR downloads Directory where downloaded files are stored inside the container. Must be mapped to a host volume.
ELENGRAB_COOKIES_DIR cookies Directory where cookie files are stored. Files must be in Netscape cookies.txt format (compatible with yt-dlp).
ELENGRAB_DOWNLOAD_WORKERS 3 Number of concurrent workers used for processing YouTube video and audio tasks in parallel.
ELENGRAB_MODE public Controls access mode. Possible values: public (anonymous, full access, shared download history), public_readonly (anonymous, read-only access to public media only), guest (anonymous, session-isolated download history), authenticated (login required, permission-based access).
ELENGRAB_BASE_URL (not set) Base URL of the Elengrab service, for example https://example.com. Used, for example, to generate short links.
ELENGRAB_ALLOW_COOKIES false Enables use of cookies for multimedia sources. Requires Deno. The youtube.txt file should be located in the directory specified by ELENGRAB_COOKIES_DIR.
ELENGRAB_MAINTENANCE_ENABLE_MOVE_UNMATCHED_FILES false Enables the periodic operation that moves files not present in the database tables from the download folder to the .lost folder. Default is false (disabled).

Volumes

Volume Description
db:/app_n/sqlite/data Stores SQLite database files.
db_backups:/app_n/sqlite/backups Stores backups of SQLite databases.
downloads:/app_n/downloads Stores downloaded files.
cookies:/app_n/cookies Stores cookie files used by the application (see ELENGRAB_COOKIES_DIR).
media:/app_n/media Stores auxiliary media files such as thumbnails and other resources.

Usage

Run as a standalone application

Elengrab is distributed as a single binary for Windows, Linux, and macOS. Download the latest release for your operating system and run the application directly without Docker.

Elengrab requires yt-dlp and ffmpeg, which are not included in the standard releases.

Platforms

Windows
Portable Windows package

The latest Windows bundle can be downloaded from the latest Elengrab release.

A portable Windows package containing the latest elengrab.exe, yt-dlp.exe, ffmpeg.exe, and ffprobe.exe is also available here.

After starting Elengrab, open http://localhost:2380 in your browser.


Standard release

Download the latest Windows release from the GitHub Releases page and run elengrab.exe.

After starting Elengrab, open http://localhost:8080 in your browser.


Linux

Download the latest Linux binary for your architecture from the GitHub Releases page.

Make the binary executable and run it:

chmod +x elengrab
./elengrab

Install yt-dlp and ffmpeg separately.

After starting Elengrab, open http://localhost:8080 in your browser.


macOS

Download the latest macOS binary for your architecture from the GitHub Releases page.

Make the binary executable and run it:

chmod +x elengrab
./elengrab

Install yt-dlp and ffmpeg separately.

After starting Elengrab, open http://localhost:8080 in your browser.


Docker

Run Docker with default settings
docker run -d \
  --name elengrab \
  -v elengrab_db:/app_n/sqlite/data \
  -v elengrab_db_backups:/app_n/sqlite/backups \
  -v elengrab_downloads:/app_n/downloads \
  -v elengrab_cookies:/app_n/cookies \
  -p 8080:8080 \
  neosy/elengrab:latest

Docker Compose

Create a file docker-compose.yml with the following content:

version: "3.8"

services:
  elengrab:
    image: neosy/elengrab:latest
    container_name: elengrab
    restart: unless-stopped
    ports:
      - "8080:8080"
    environment:
      TZ: "Europe/Moscow"
      ELENGRAB_DOWNLOAD_WORKERS: "3"
    volumes:
      - elengrab_db:/app_n/sqlite/data
      - elengrab_db_backups:/app_n/sqlite/backups
      - elengrab_downloads:/app_n/downloads
      - elengrab_cookies:/app_n/cookies

Then:

docker-compose up -d

After this, Elengrab will be accessible at http://localhost:8080


Docker Compose for Docker Swarm

Create a file docker-compose.yml with the following content:

version: '3.5'

services:
  server:
    image: neosy/elengrab
    ports:
      - 8080:8080
    environment:
      TZ: "Europe/Moscow"
      ELENGRAB_DOWNLOAD_WORKERS: "3"
    volumes:
      - db:/app_n/sqlite/data
      - db_backups:/app_n/sqlite/backups
      - downloads:/app_n/downloads
      - cookies:/app_n/cookies
    deploy:
      mode: replicated
      replicas: 1
      resources:
        limits:
          cpus: "4.0"
          memory: "4G"

volumes:
  db:
  db_backups:
  downloads:
  cookies:

Deploying in Docker Swarm

  1. Initialize Docker Swarm (if not already initialized):
docker swarm init
  1. Deploy the stack using your docker-compose.yml:
docker stack deploy -c docker-compose.yml elengrab
  1. Check the running services:
docker service ls
  1. Access Elengrab at http://<your-host-ip>:8080 and start managing your personal video and audio content.

Donations

If you find Elengrab useful, you can support its development:

Donate

License

Copyright (C) 2025–2026 Yury Savonin (Neosy)

This project is licensed under the GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later).

See the LICENSE file for the full license text.