insta - AVDownload & Tags

insta is a powerful Bash-based media downloader and tagger, part of the EMSF toolset by efxtv. It is built on top of yt-dlp, ffmpeg, and aria2, and is designed for fast, clean, and automated video/audio downloads with metadata handling and MP3 cover art tagging.

This tool works on Linux and Termux (Android).

✨ Features

• 📥 Download videos (MP4) and audio (MP3)
• 🎵 Extract high-quality audio from videos
• 📂 Playlist downloads (video & audio)
• 📄 Batch downloads using list files
• 🖼️ Thumbnail downloader (single & batch)
• 🏷️ MP3 cover art tagging (single or bulk)
• 🚀 Optional high-speed downloads using aria2
• 🧹 Automatic filename sanitization
• 🤖 Works on both Desktop Linux and Termux

📦 Dependencies

The script can automatically install dependencies for you.

Required tools

• yt-dlp
• ffmpeg
• curl
• aria2
• atomicparsley
• python / python3

On Termux, packages are installed using pkg. On Linux, packages are installed using apt.

🔧 Installation

Clone or copy the script into your system and make it executable:

chmod +x insta

(Optional) Move it into your PATH:

sudo mv insta /usr/local/bin/

Install dependencies automatically

insta -i

🚀 Usage

insta [option] [URL/File/Path] [Image]

Help Menu

insta -h

📥 Download Options

🎬 Download Video (MP4)

insta -v <url>

🎧 Download Audio (MP3)

insta -a <url>

⚡ Fast Mode (aria2)

Add -fast at the end for multi-connection downloads:

insta -v <url> -fast

📂 Playlist Downloads

🎬 Playlist Video

insta -pv <playlist_url>

🎧 Playlist Audio

insta -pa <playlist_url>

Files are saved in a folder named after the playlist.

📄 Batch Downloads (List Files)

Create a text file with one URL per line.

🎬 Video List

insta -lv list.txt

🎧 Audio List

insta -la list.txt

🖼️ Thumbnail Downloader

Single URL Thumbnail

insta -t <url>

Saved to:

thumbnails_export/

Batch Thumbnail Download

insta -ta list.txt

Saved to:

thumbl/

🏷️ MP3 Tagging (Cover Art)

Tag ALL MP3s in Current Directory

insta -taga cover.jpg

Tag a Specific MP3 File

insta -tagp song.mp3 cover.jpg

Uses ID3v2.3 for maximum compatibility.

🧹 Filename Cleaning

After downloads, filenames are automatically cleaned:

• Special characters removed
• Spaces replaced with -
• Windows-safe filenames

Example:

My Video Title!!! [abc123].mp4
↓
My-Video-Title-abc123.mp4

🔄 Update yt-dlp

insta -u

📁 Output Structure

• Downloads are saved in the current directory
• Playlists create their own subfolders
• Thumbnails go into thumbnails_export/ or thumbl/

🧠 Notes

• Designed for automation and scripting
• Tested on Linux and Termux
• Requires active internet connection
• Some platforms may restrict certain URLs

🛠️ Part of EMSF

This project is part of the EMSF (Extended Media Script Framework) by efxtv.

📜 License

MIT License

Use freely, modify responsibly.

How to install ? Download Emsf tool and run command

emsf server
>insta

👤 EFXTv