API to embed media files
  • JavaScript 100%
Find a file
BlackusPL 04dc15490a Update 09.06.2026
This update is big ngl, mainly because of the switch from Express to Hono.

**Added**
- Options to compile app to specific operating system
- Banner on startup
- Support for Bun

**Changed**
- Switched `express` to `hono`
- Name to compile app was changed from `build` to `compile` to match name
- Default IP is now `127.0.0.1` instead of `0.0.0.0`
- Removed `express`
2026-06-09 01:42:28 +02:00
.github Remove FORCE_JAVASCRIPT_ACTIONS_TO_NODE24 env var (no longer needed) 2026-04-25 02:37:50 +00:00
locales Revamp of main website page 2026-04-08 00:55:17 +02:00
public Update 09.06.2026 2026-06-09 01:42:28 +02:00
src Update 09.06.2026 2026-06-09 01:42:28 +02:00
.example.env Update 09.06.2026 2026-06-09 01:42:28 +02:00
.gitignore Update 09.06.2026 2026-06-09 01:42:28 +02:00
CHANGELOG.md Update 09.06.2026 2026-06-09 01:42:28 +02:00
deno.json Update 09.06.2026 2026-06-09 01:42:28 +02:00
deno.lock Update 09.06.2026 2026-06-09 01:42:28 +02:00
package.json Update 09.06.2026 2026-06-09 01:42:28 +02:00
README.md Update 09.06.2026 2026-06-09 01:42:28 +02:00

EmbedDLP

API that allows you to embed or download every video and audio from supported sites by yt-dlp on platforms like Discord, Telegram, WhatsApp and more.

Note

This project wasnt supposed to see daylight and some things could still be related to my stuff

Prebuilds They are only available for 90 days after new commit

Windows Download

Ubuntu Download

Installation

# Clone this repository
git clone https://git.nadeko.net/BlackusPL/EmbedDLP.git
cd EmbedDLP

Use via...

Deno (Recommended)
deno install
deno task start # or deno run start  or 'deno src/app.js'
Nodejs
npm install
npm start # or 'node src/app'
Bun
bun install
bun src/app.js # or 'bun start'

Endpoints

/ - Opens home page

/universal - Main endpoint, arguments:

  • ?q=<url> - video/audio link that should be embeded
  • ?video=<true/1/false/0> - if embeded file should be a video or audio (optional, default=false)

/music - Embeds spotify songs as a audio file, arguments:

  • ?q=<url> - spotify link that should be embeded as a audio file
  • ?ss=<int> - choose in order wich song should be used (optional, default=1)

Outputs

Embedded files by default have 5 minutes before get terminated in next execution of app. They are stored in output/files_expiration.json.

Example structure:

{
    "example.mp3": {
        "created_at": "1771544044840",
        "expiration": "1771544345231",
        "source_urls": [
            "http://example.com/example.mp3"
        ]
    }
}

Temporary videos and audios are stored in output directory and are not accesible trough site.

To change expiration time, in .env use EXPIRATION_TIME in seconds.

Locales

You can create translation to your language by creating json file in locales directory.

Standalone Builds

Using Deno you can compile this app to binary file that can be run anywhere. Simply type deno run compile and you good to go.