By choosing “preferences” or by running stream2ip with the option -s from a terminal the setup program will be called to make various settings.


All settings will be stored in ~/.config/stream2ip/s2ip.cfg. A backup file will always created.

If stream2ip does not start on erroneous settings we can still call stream2ip -s from a terminal to change preferences.

Startup/Quit options

  • Save settings on quit: Any changes made to the settings line at run time are saved (for the presently loaded device) before quitting stream2ip.
  • Autoconnect: Stream2ip waits the given time to kook  for a device to be ready to then automatically establish a connection. If a device gets lost stream2ip re-establishes the connection an re-appearance of the device. Connection to the default device is automatically established on start up. Setting the time to look up devices to 0 only connects on start-up but does not scan for a device to be present.
  • Minimize on connection: As soon as the connection is established the program will minimize to tray. Only the status icon is shown if enabled.
  • Disconnect on quit: On program termination the device will be disconnected. This option is needed to disconnect all loaded Pulse Audio modules (e.g. RAOP) without having to reset Pulse Audio.
  • Disable panel icon: This option disables the Application Indicator in the panel. We need to restart stream2ip to take effect.
  • Seconds to look up devices: This enables scanning for devices every given seconds (recommeded for Bluetooth min. 4s, Airport Express min. 6s, DLNA-live min. 6s). As soon as the device is ready stream2ip will connect and set it as default sink in PulseAudio. If set to 0 auto-connecting is disabled. If a media player was chosen or in case we are streaming a playlist this is the time span after which meta-tag informations for artist and title are updated.


There is a drop-down list for devices/streaming methods to choose from. The appropriate settings in the line right to this list may be edited for each device separately and will be stored on Ok. See the corresponding pages for more details:

  • Airport Express: give in IP and Port (e.g.
  • Bluetooth:  given in MAC (e.g. 00:0C:78:4F:B6:B5 ) or Auto for auto-detecting
  • UPnP/DLNA:  UShare needs path(s) to media library (e.g. /home/user/music) or MiniDLNA is minidlna.
  • DLNA live: If left empty the next possible renderer will be chosen. To connect to a given renderer enter renderer URL or name:IP of the renderer (e.g. living room@
  • Internet Radio:  live or local for live audio streams. Sending a playlist needs a path/to/playlist.m3u.

On Ubuntu or any other distribution using apt stream2ip will offer to install packages needed for the chosen streaming method.


Ticked packages will have to be installed, those marked with an asterisk are optional but at least one is still needed.

Other distribution need to install these packages through their package manager.

Some packages may need to have an appropriate repository or a PPA in our sources. Pulseaudio-DLNA can be obtained from GIT or through adding the project’s PPA (on Launchpad):


Some packages need additional configurations to be made before we can use them with stream2ip.

Media Player

We can choose from a drop-down list of supported media players to enable sending meta-tag information to an Icecast server or for display on the stream2ip window. Presently supported are the following players: Amarok, Audacious, Banshee, Clementine, Guayadeque, and Rhythmbox. If your favorite player is missing, let us know. Some players may need an additional MPRIS2 plugin to load.


If we tick connect to this player then the selected media player will start as soon as a connection to a streaming device was sucessfully established.

Command to run after connecting

This line is a bash command line for giving commands that will run as soon as a connection was established. This can be any command from a notification to a script we had made for any custom purpose.