stream

Package: WA2L/WinTools 1.2.10
Section: Library Commands (3)
Updated: 14 June 2026
Index Return to Main Contents

 

NAME

stream - stream MP3 files over HTTP

 

SYNOPSIS

WA2LWinTools/lib/stream [ -h | -i | -u | -V ]

stream -d dir...

stream [ -p port ] [ -e ] [ -l ] [ -s | -o ] -d dir...

 

AVAILABILITY

WA2L/WinTools

 

DESCRIPTION

stream is a simple and lightweight command to broadcast MP3 files from a list of directories over HTTP with minimal configuration effort.

The stream can be connected thru http://localhost:9000, http://<servername>:9000, or http://<ip address>:9000 for example using radiosure(1) or a web browser.

The default port 9000 can be changed using the '-p port' option. This can also be used to realize multiple broadcast streams (~radio stations) each on its specific port serving specific genres by selecting related directories.

 

OPTIONS

-h
help message.

-V
print program version.

-i
install the stream command on the Windows™ 'Desktop'.

The shortcut must then be modified manually:

Stream MP3 Shortcut
-> Right click
-> Target: set options
-> Run: Normal window | Minimized
-> [ OK ]

to set at least the -d dir... option to point to a valid directory.

It is recommended to also rename the created shortcut to avoid unintentional overwriting of the modified settings.

-u
uninstall the stream command from the Windows™ 'Desktop'.

-p port
network port to provide the broadcast stream.

Default port is 9000.

This option can be used to realize multiple broadcast streams (~radio stations) serving specific genres by selecting related directories.

-e
endless broadcast loop of the MP3 files.

-l
long file name output.

-s
shuffle the MP3 files found.

-o
order the MP3 files found by file name.

-d dir...
space separated list of directories searched recursively for MP3 files.

If a directory has spaces in the name, it needs to be enclosed by double quotes (e.g.: -d "h:\dat\my music").

 

ENVIRONMENT

-

 

EXIT STATUS

0
no error.

1
error.

4
usage printed.

5
version printed.

 

FILES

-

 

EXAMPLES

1) Connect with RadioSure
To add a broadcast stream that is served on the system with the IP address 10.11.12.13 on port 9000:

RadioSure
-> Station List
-> Right click
-> Add new station
-> Title: My Broadcast Stream
-> Source URL: http://10.11.12.13:9000
-> [ Save ].

2) Connect with a web browser
To play a broadcast stream served on the system with the IP address 10.11.12.13 on port 9000 in a web browser:

enter the stream URL http://10.11.12.13:9000 in the address bar.

 

SEE ALSO

wintoolsintro(1), ipconfig(1), ifconfig(1), radiosure(1)

 

NOTES

To print the IP addresses of a system, the ipconfig(1) or ifconfig(1) command can be used.

When starting the stream command the Windows™ firewall will pop up once per stream asking to allow communication to the broadcast. This must be confirmed when you want to connect to the broadcast stream for example within your home WLAN network from another computer or a mobile device.

 

BUGS

-

 

AUTHOR

stream was developed by Christian Walther. Send suggestions and bug reports to wa2l@users.sourceforge.net . 

 

COPYRIGHT

Copyright © 2026 Christian Walther

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


 

Index

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
OPTIONS
ENVIRONMENT
EXIT STATUS
FILES
EXAMPLES
SEE ALSO
NOTES
BUGS
AUTHOR
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 21:36:22 GMT, June 26, 2026