Skip to content

🎬 Transform any web directory into beautifully organized M3U/M3U8 playlists. Smart media detection, recursive scanning, and real-time progress tracking in a modern UI. Perfect for managing your media collections! 🎡

License

Notifications You must be signed in to change notification settings

hasanbeder/M3Unator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

M3Unator - Web Directory Playlist Creator

M3Unator Banner

Version License GitHub stars Greasyfork

🎯 Create M3U/M3U8 playlists from web directory listings with ease!

Browse through Apache, Nginx, or any other web server's directory listing and let M3Unator generate a playlist of all media files. It recognizes popular formats like MP4 and MP3, as well as specialized ones like MKV and FLAC. With its clean dark interface and real-time scanning status, creating playlists has never been simpler.

Installation Features Usage Formats FAQ Contributing Documentation

✨ What's New in v1.0.2

πŸš€ Performance Enhancements

  • Ultrafast scanning system with lightning-quick directory processing
  • Optimized memory management for better resource utilization
  • Enhanced caching system for improved performance
  • Parallel request limit increased to 15 for faster scanning

🌐 Web Server Support

  • Improved Apache/Nginx directory listings support
  • Added LiteSpeed directory support
  • Optimized link extraction and processing
  • Enhanced URL validation and handling

πŸ›‘οΈ Security & Stability

  • Smart retry mechanism with exponential backoff
  • Advanced error handling with detailed reporting
  • Enhanced security features and validations
  • Improved character encoding support

πŸ“Š UI/UX Improvements

  • Beautiful toast notifications system
  • Real-time progress tracking with detailed stats
  • Colored log categories for better visibility
  • Activity indicator for real-time operation status

🎯 Installation

  1. Install a userscript manager:

  2. Install M3Unator:

Note: For Tampermonkey v5.0+, enable developer mode in your browser's extensions settings.

⚑ Quick Start

  1. Install Tampermonkey & M3Unator
  2. Visit any directory listing page
  3. Click M3Unator button (top-right)
  4. Hit "Create Playlist" - Done! πŸŽ‰

Need more details? Check the full usage guide β†’

🎯 Core Features

🎬 Media Support

  • Comprehensive support for 40+ media formats
  • Smart file type detection using Map structure
  • Enhanced character encoding for international files
  • Automatic media file filtering

πŸ” Directory Scanning

  • Configurable scanning depth
  • Smart subdirectory handling
  • Efficient file discovery
  • Progress tracking and statistics

🎨 User Interface

  • Modern dark theme design
  • Intuitive controls and settings
  • Real-time status updates
  • Clean and responsive layout

πŸ“– What are Open Directories?

Open Directories are publicly accessible web server directories with directory listing enabled. These are web pages that display a list of files and folders, similar to how you view files on your computer. They are commonly found on Apache, Nginx, Lighttpd, LiteSpeed, and other web servers where directory indexing is enabled. These directories allow direct access to browse and download files through your web browser.

Example directory structure:

Index of /movies/
[DIR] Action/
[DIR] Comedy/
[FILE] movie1.mp4
[FILE] movie2.mkv

M3Unator is designed to work with these directory listings, automatically detecting media files and creating organized playlists.

πŸ” Finding Open Directories

Click to expand search techniques

Basic Search Syntax

intitle:"index of" "parent directory"

For Video Content

intitle:"index of" (mp4|mkv|avi|mov) -inurl:(jsp|pl|php|html|aspx)

For Audio Content

intitle:"index of" (mp3|flac|m4a|wav) -html -htm -php -asp

For Specific Content

intitle:"index of" "your search term" (mp4|mkv) -html

Understanding the Search Operators:

  • intitle:"index of" - Finds pages with "index of" in their title
  • "parent directory" - Common text found on directory listing pages
  • -inurl:(jsp|pl|php|html|aspx) - Excludes dynamic pages
  • (mp4|mkv|avi|mov) - Searches for specific file types

πŸ“ Supported Formats

🎬 Video Files

mp4 mkv avi webm mov flv wmv m4v mpg mpeg 3gp vob ts mts m2ts divx xvid asf ogv rm rmvb qt hevc f4v

🎡 Audio Files

mp3 m4a wav flac aac ogg wma opus aiff ape mka ac3 dts m4b mp2 mpa mpc ra tta voc

πŸ’‘ Usage

  1. Navigate to any directory listing page
  2. Click the M3Unator button in the top-right corner
  3. Configure your preferences:
    • Select media types (video/audio)
    • Set scanning depth
    • Choose output format (M3U/M3U8)
  4. Click "Create Playlist"
  5. Monitor real-time progress
  6. Save your playlist file

βš™οΈ Configuration Options

Option Description Default Range
Media Types Choose video and/or audio files Both enabled -
Scan Depth Set directory scanning depth Unlimited 0-99
Format Choose between M3U and M3U8 M3U -
Parallel Requests Number of concurrent requests 15 1-20
Timeout Request timeout duration 10000ms 5000-30000ms
Retry Count Number of retry attempts 3 0-5
Retry Delay Initial retry delay (doubles each retry) 1000ms 500-5000ms

πŸ” Browser Compatibility

Browser Support Minimum Version Notes
Chrome βœ… 88+ Fully supported
Firefox βœ… 78+ Fully supported
Edge βœ… 88+ Fully supported
Safari ⚠️ 14+ Limited support
Opera βœ… 74+ Fully supported

❓ FAQ

Why isn't the M3Unator button appearing? Ensure you're on a directory listing page and your userscript manager is properly installed and enabled.
Why are some files skipped during scanning? Files might be in unsupported formats, inaccessible, or blocked. Check the colored log for detailed information.
How do I scan subdirectories efficiently? Enable recursive scanning in settings. Use the depth level indicator to monitor progress in deep directory structures.
What's the best way to handle large directories? The new ultrafast scanning system handles large directories efficiently. You can also use the depth setting to limit scanning scope.

🀝 Contributing

We welcome contributions! Please check our Contributing Guidelines before submitting pull requests.

Development Resources

πŸ“„ License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Our amazing contributors
  • The open-source community
  • Users providing valuable feedback and suggestions

πŸ“¬ Contact & Support

πŸ“š Additional Resources


Author

Stars Forks Issues

Support the Project
⭐ Star the repository
πŸ”„ Share with the community
πŸ› οΈ Submit issues and contribute

Follow on GitHub Follow on X

About

🎬 Transform any web directory into beautifully organized M3U/M3U8 playlists. Smart media detection, recursive scanning, and real-time progress tracking in a modern UI. Perfect for managing your media collections! 🎡

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published