DEV Community

David
David

Posted on

Building a YouTube Shorts Downloader: Why It’s Harder Than It Looks

#webdev #youtube #ffmpeg

Paste a URL, click a button, get an MP4.

At first glance, a YouTube Shorts downloader sounds like one of the simplest web tools you could build.

But once you go beyond the prototype stage, things become more interesting.

You have multiple video formats, separate audio and video streams, different codecs, FFmpeg merging, audio conversion, temporary files, bandwidth usage, and a source platform that can change its behavior at any time.

In this post, I want to explain what actually happens behind a seemingly simple Download button.

The basic flow

From the user's perspective, the process looks like this:

YouTube Shorts URL
        ↓
Paste URL
        ↓
Choose quality
        ↓
Download MP4
Enter fullscreen mode Exit fullscreen mode

On the server, the pipeline is closer to:

URL
 ↓
Validate URL
 ↓
Extract video metadata
 ↓
Detect available formats
 ↓
Select video/audio streams
 ↓
Download required streams
 ↓
Merge or convert if necessary
 ↓
Return the final file
Enter fullscreen mode Exit fullscreen mode

Most of the complexity is hidden between "detect available formats" and "return the file."

YouTube doesn't always give you one ready MP4

One of the first things you notice when working with YouTube media is that a video is not necessarily available as one convenient file containing both high-quality video and audio.

Higher-quality formats commonly use separate streams.

You may have something conceptually like:

1080p video
video only
Enter fullscreen mode Exit fullscreen mode

and separately:

audio
audio only
Enter fullscreen mode Exit fullscreen mode

If the user asks for a 1080p MP4, you may therefore need to download both streams and combine them.

So instead of:

YouTube → MP4
Enter fullscreen mode Exit fullscreen mode

the process becomes:

YouTube
   ↓
1080p video stream
   +
audio stream
   ↓
FFmpeg
   ↓
final.mp4
Enter fullscreen mode Exit fullscreen mode

For the user, this still looks like one download.

For the server, it can mean two network transfers plus additional processing.

Why FFmpeg becomes important

FFmpeg is one of the most useful tools in this kind of project.

If the video and audio are already encoded in compatible formats, FFmpeg can often combine them without re-encoding everything.

A simplified example looks like:

ffmpeg -i video.mp4 -i audio.m4a -c copy output.mp4
Enter fullscreen mode Exit fullscreen mode

This is much better than unnecessarily converting the entire video because copying existing streams is faster and uses less CPU.

But format compatibility matters.

You cannot assume every video stream and every audio stream can simply be placed into every container.

This is why format selection becomes an important part of the application instead of blindly choosing the file with the highest resolution.

Format selection is more complicated than resolution

A user sees options like:

360p
720p
1080p
Enter fullscreen mode Exit fullscreen mode

A downloader sees much more information:

container
video codec
audio codec
bitrate
resolution
FPS
video-only / audio-only
file size
Enter fullscreen mode Exit fullscreen mode

For example, two formats may both be 1080p but use different codecs.

One might be more convenient for MP4 delivery, while another might be optimized for WebM.

So choosing a format only by height is not enough.

You need some selection logic.

Conceptually:

requested resolution
        ↓
find compatible video stream
        ↓
find suitable audio stream
        ↓
determine whether merging is required
Enter fullscreen mode Exit fullscreen mode

This gets even more important when the original Short does not have the exact quality requested by the user.

A downloader should not pretend that a 720p source suddenly became real 1080p.

MP3 is another interesting case

Downloading audio also has two different scenarios.

If the original audio stream is already available in a useful format such as M4A, the service may be able to deliver that stream without converting it.

MP3 is different.

You generally need to extract or convert the audio:

YouTube video
     ↓
audio stream
     ↓
FFmpeg
     ↓
MP3
Enter fullscreen mode Exit fullscreen mode

There is also an important misconception around audio quality.

Converting a lower-bitrate source into:

320 kbps MP3
Enter fullscreen mode Exit fullscreen mode

does not magically add quality that didn't exist before.

It only creates an MP3 encoded at that bitrate.

The source quality still determines the actual amount of audio information available.

Why I decided to support only YouTube Shorts

When building FromYT, I intentionally focused on Shorts instead of trying to support every possible YouTube URL.

That decision simplifies the product in several ways.

Short videos mean smaller files, shorter processing times and lower bandwidth requirements.

Compare processing a 30-second Short with processing a three-hour video.

Even if the underlying extraction process is similar, the infrastructure requirements are completely different.

Large videos can require:

more bandwidth
more temporary storage
longer HTTP connections
longer FFmpeg processes
higher failure probability
Enter fullscreen mode Exit fullscreen mode

Limiting the service to Shorts gives the application a much more predictable workload.

It also keeps the purpose of the site clear.

Instead of becoming another generic downloader supporting dozens of platforms and media types, FromYT does one specific thing.

Temporary files need attention

If the server has to merge streams, it normally needs temporary files.

For example:

/tmp/job-123/video.mp4
/tmp/job-123/audio.m4a
/tmp/job-123/final.mp4
Enter fullscreen mode Exit fullscreen mode

Those files must eventually disappear.

If they don't, disk usage can grow surprisingly quickly.

Imagine an average processing job temporarily using 50 MB.

With 10,000 jobs, that's potentially:

50 MB × 10,000 = 500 GB
Enter fullscreen mode Exit fullscreen mode

Of course, you should delete files after each job, but failures also need to be considered.

What happens if FFmpeg crashes?

What happens if the user closes the page?

What happens if the network request times out halfway through?

Cleanup should therefore not rely only on the application's normal success path.

A periodic cleanup process is useful as a second layer of protection.

Bandwidth can become more important than CPU

At first, I expected media processing to mostly be a CPU problem.

In many cases, bandwidth is actually the bigger concern.

Consider a simplified example.

A user downloads a 40 MB video.

Your server may need to:

download 40 MB from the source
+
send 40 MB to the user
Enter fullscreen mode Exit fullscreen mode

That is already around 80 MB of transfer associated with one request.

If separate streams are required, there may be multiple source downloads before the final file is sent.

At scale, even relatively small videos create a lot of traffic.

For services like this, bandwidth planning can become just as important as application optimization.

Another problem: the source platform keeps changing

A normal web application communicates with APIs and systems you control.

A downloader depends on a platform you don't control.

That changes the maintenance model.

Something that works today may stop working because of changes to:

page structure
player behavior
video formats
JavaScript
request validation
rate limits
bot detection
Enter fullscreen mode Exit fullscreen mode

This is one reason tools such as yt-dlp are so valuable.

A huge amount of platform-specific extraction logic is maintained by the open-source community.

Instead of implementing every extraction rule yourself, your application can focus on everything around it:

validation
queues
format selection
rate limiting
storage
FFmpeg processing
error handling
delivery
UI
Enter fullscreen mode Exit fullscreen mode

But it also means keeping the extraction layer updated is part of running the service.

A downloader is not really a "build it once and forget it" type of application.

Error handling matters more than I expected

There are many reasons a download may fail.

For example:

invalid URL
deleted video
private video
unavailable video
age restriction
temporary network failure
format unavailable
extraction failure
FFmpeg failure
Enter fullscreen mode Exit fullscreen mode

Simply returning:

Something went wrong
Enter fullscreen mode Exit fullscreen mode

is easy, but it creates a bad user experience.

It's better to categorize failures whenever possible.

For example:

This video is unavailable.

This URL is not a YouTube Short.

The requested quality is not available.

The video could not be processed. Please try again.
Enter fullscreen mode Exit fullscreen mode

Good error messages are especially important for tools where the user cannot see what is happening behind the scenes.

Protecting the service from abuse

Any public endpoint that triggers network requests or media processing can be abused.

Without limits, someone could automate thousands of download requests.

So even a simple downloader eventually needs things such as:

rate limiting
maximum video duration
request validation
concurrency limits
timeouts
job limits
Enter fullscreen mode Exit fullscreen mode

The purpose is not only protecting the server from malicious users.

Limits also prevent accidental overload.

A small number of users running many expensive requests simultaneously can have the same effect as intentional abuse.

The UI should hide most of this complexity

The funny part is that, after implementing all of this, the best frontend is still extremely simple.

The user should see something like:

Paste YouTube Shorts URL
        ↓
Choose format
        ↓
Download
Enter fullscreen mode Exit fullscreen mode

They should not have to understand codecs, adaptive streams, muxing or FFmpeg.

All of that complexity exists specifically so the user doesn't have to think about it.

That is one of the things I enjoy about building small web tools.

The simpler the interface looks, the more engineering may be hidden behind it.

What I ended up building

I eventually turned this experiment into FromYT.net:

https://fromyt.net/en

It is focused specifically on YouTube Shorts and currently supports downloading video in different available qualities as well as extracting audio.

The project is intentionally narrow.

I would rather keep one small tool reliable than add every possible media platform immediately.

What I learned

Building the first prototype was easy.

Making it something I would actually want people to use required thinking about much more than downloading a video.

The most important lessons were:

  • Media downloading is partly an infrastructure problem.
  • Higher resolution often means separate video and audio streams.
  • FFmpeg is incredibly useful for merging and conversion.
  • Bandwidth becomes expensive faster than expected.
  • Temporary files require reliable cleanup.
  • Format selection needs more logic than simply choosing the highest resolution.
  • Third-party platforms can change at any time.
  • Narrowing the scope of a product can dramatically simplify its infrastructure.

The final result is still just a box where you paste a URL and press a button.

And that's probably exactly how it should be.

Top comments (0)