How to set up DudelDu with Docker for streaming my MP3 collection?

Pull the Docker image from Dockerhub, mount your media directory as a volume, and run the container with the playlist parameter. The README provides a command example using docker run with host and port settings.

DudelDu vs Icecast: which should I use for a small internet radio station?

DudelDu is simpler and easier to set up with JSON playlists and Go embedding, while Icecast offers more features and broader protocol support. Choose DudelDu for basic, lightweight streaming; Icecast for advanced customization and scalability.

Can DudelDu stream live video or is it only for pre-recorded files?

DudelDu primarily streams pre-recorded media files like MP3 and NSV, as per the README. It doesn't support live encoding or real-time streaming, so it's not suitable for live broadcasts without external tools.

What authentication methods does DudelDu support?

It supports HTTP basic user authentication, which can be set via command-line options or environment variables, as detailed in the usage section. This is sufficient for simple access control but lacks OAuth or advanced security features.

Is DudelDu suitable for embedding in a Go web application?

Yes, DudelDu can be embedded in other Go projects, making it a good choice for adding streaming capabilities without heavy dependencies. The README mentions this as a feature, allowing integration into custom applications.

How to shuffle playlists in DudelDu?

Use the -shuffle command-line option when starting the server to randomize playlist order, as mentioned in the usage section. This is a simple way to vary stream content without manual playlist editing.

Open-Awesome

dudeldu

MITGov1.3.0

A simple audio/video streaming server implementing the SHOUTcast protocol for media broadcasting.

GitHub

148 stars16 forks0 contributors

What is dudeldu?

DudelDu is a lightweight streaming server that uses the SHOUTcast protocol to broadcast audio and video content over HTTP. It enables users to set up their own self-hosted streaming service for media files stored on disk, supporting various clients and providing metadata transmission.

Target Audience

Developers or hobbyists looking to self-host simple audio/video streaming services, such as for personal media libraries, small radio stations, or embedded streaming within Go applications.

Value Proposition

Developers choose DudelDu for its simplicity, flexibility, and lack of complex dependencies, offering a straightforward solution for streaming with support for SHOUTcast protocol, metadata, and easy integration as a standalone server or embedded component in Go projects.

Overview

A simple SHOUTcast server.

Use Cases

Best For

Self-hosting personal audio or video streaming from local media files.
Setting up a small internet radio station using the SHOUTcast protocol.
Embedding a streaming server within a Go application without heavy dependencies.
Streaming to clients like VLC, ServeStream, or Icecast-compatible players.
Broadcasting with metadata (artist/title) support for enhanced client displays.
Securing streams with HTTP basic authentication for controlled access.

Not Ideal For

Projects requiring adaptive bitrate streaming or live encoding, as DudelDu focuses on static media files with SHOUTcast protocol.
Applications needing built-in web interfaces or advanced user management, since it offers only basic command-line control and HTTP authentication.
Browser-based streaming without client software, as it relies on SHOUTcast which may not be natively supported in all browsers.

Pros & Cons

Pros

Broad Client Compatibility

Works with popular clients like VLC and ServeStream, as stated in the README, ensuring flexible playback across devices without proprietary software.

Simple Playlist Management

Uses JSON files for playlists and standard media files (e.g., MP3, NSV), making setup straightforward without complex databases or encoding requirements.

Dual Deployment Options

Can run standalone or be embedded in Go applications, providing flexibility for different use cases, as highlighted in the features section.

Metadata Support

Sends artist and title information to clients, enhancing the streaming experience with track details, a key feature mentioned in the README.

Cons

Limited Protocol Support

Only supports SHOUTcast protocol, which is older and less compatible with modern browsers compared to HLS or DASH, restricting its use in web-centric applications.

Manual Configuration Required

Requires creating JSON playlists and setting up authentication manually, which can be tedious for dynamic or large-scale streams, as there's no built-in GUI or automation tools.

Basic Feature Set

Lacks advanced features like transcoding, dynamic playlists, or built-in analytics, limiting its use for professional or high-demand streaming services.

Frequently Asked Questions

Related Projects

Caddy

Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS

Stars74,310

Forks4,844

Last commit3 days ago

minio

MinIO is a high-performance, S3 compatible object store, open sourced under GNU AGPLv3 license.

Stars61,384

Forks7,681

Last commit3 months ago

etcd

Distributed reliable key-value store for the most critical data of a distributed system

Full-featured and highly configurable SFTP, HTTP/S, FTP/S and WebDAV server - S3, Google Cloud Storage, Azure Blob

Stars12,306

Forks946