streamtuner2: settings.json
Internet radio browser GUI for music/video streams from various directory services.

⌈⌋ branch:  streamtuner2


settings.json

Streamtuner2 has a configuration file in ~/.config/streamtuner2/settings.json. You can edit it with any text editor. But take care to correctly pair quotes, and don't omit commas between group values.

{
    "auto_save_appstate": true, 
    "auto_save_stations": true, 
    "debug": true, 
    "dir": "/home/mario/.config/streamtuner2", 
    "dirble_api_key": "", 
    "dnd_format": "srv", 
    "favicon_delete_stub": true, 
    "favicon_google_first": true, 
    "file_browser_dir": "$XDG_MUSIC_DIR, ~/MP3", 
    "file_browser_ext": "mp3,ogg, m3u,pls,xspf, avi,flv,mpg,mp4", 
    "filter_walledgardens": true, 
    "filtermusic_src": "web", 
    "google_homepage": true, 
    "heuristic_bookmark_update": false, 
    "history": "20", 
    "icon_dir": "/home/mario/.config/streamtuner2/icons", 
    "internetradio_max_pages": "5", 
    "jamendo_count": "1", 
    "jamendo_image_size": "35", 
    "jamendo_stream_format": "ogg", 
    "jitrecord_ripper": "streamtripper", 
    "jitrecord_target": "$HOME/Music", 
    "jitrecord_timeout": "15", 
    "jitrecord_tmp": "/tmp/streamtuner2/recording/", 
    "like_my_bookmarks": false, 
    "load_favicon": true, 
    "max_streams": "500", 
    "min_bitrate_mp3": "64", 
    "min_bitrate_ogg": "48", 
    "myoggradio_login": "user:password", 
    "myoggradio_morph": false, 
    "nothreads": false, 
    "play": {
        "audio/*": "vlc --one-instance", 
        "audio/mpeg": "vlc --one-instance", 
        "audio/ogg": "vlc --one-instance", 
        "audio/soundcloud": "false / convert", 
        "url/http": "opera", 
        "video/*": "vlc --one-instance", 
        "video/youtube": "vlc  --one-instance $(youtube-dl -g %srv)"
    }, 
    "playlist_asis": false, 
    "plugin_auto": true, 
    "plugin_dir": "/home/mario/.config/streamtuner2/plugins", 
    "plugin_repos": "http://fossil.include-once.org/repo.json/streamtuner2/contrib/*.py, http://fossil.include-once.org/repo.json/streamtuner2/channels/*.py", 
    "plugins": {
        "bookmarks": true, 
        "bookmarks_show_extra": true, 
        "channels.continuous_record": false, 
        "configwin": true, 
        "continuous_record": false, 
        "delicast": true, 
        "dev_faulthandler": true, 
        "di": true, 
        "dirble": true, 
        "dnd": true, 
        "exportcat": true, 
        "favicon": true, 
        "file": false, 
        "filter_bitrate": true, 
        "filtermusic": true, 
        "global_key": false, 
        "glrp": false, 
        "history": true, 
        "housemixes": true, 
        "internet_radio": true, 
        "jamendo": true, 
        "links": true, 
        "listenlive": false, 
        "live365": true, 
        "magnatune": false, 
        "modarchive": true, 
        "myoggradio": true, 
        "new_station": true, 
        "pluginmanager2": true, 
        "publicradiofan": false, 
        "punkcast": false, 
        "radiobrowser": true, 
        "radionet": true, 
        "radionomy": true, 
        "radiosure": true, 
        "radiotray": false, 
        "reciva": true, 
        "record_stop": true, 
        "reddit": true, 
        "search": true, 
        "shoutcast": true, 
        "somafm": false, 
        "specbuttons": true, 
        "streamedit": true, 
        "surfmusik": true, 
        "timer": true, 
        "tunein": true, 
        "ubuntuusers": true, 
        "ui_cht": true, 
        "url_soundcloud": true, 
        "useragentswitcher": true, 
        "version_check": true, 
        "vtuner": true, 
        "windowsmedia": false, 
        "xiph": true, 
        "youtube": true
    }, 
    "punkcast_img": true, 
    "pyquery": true, 
    "radiobrowser_cat": "languages", 
    "radionomy_pages": "3", 
    "radionomy_update": false, 
    "radiotime_group": "music", 
    "radiotime_maxpages": "9", 
    "radiotray_map": "group", 
    "record": {
        "audio/*": "xfce4-terminal -e \"streamripper %srv\"", 
        "video/youtube": "xfce4-terminal -e \"youtube-dl %srv\""
    }, 
    "reddit_keep_all": false, 
    "reddit_pages": "3", 
    "retain_deleted": true, 
    "reuse_m3u": true, 
    "share": "/home/mario/projects/streamtuner2", 
    "show_bookmarks": true, 
    "show_favicons": 1, 
    "somafm_bitrate": "64", 
    "specbutton_rows": "2", 
    "specbuttons": {
        "/usr/share/icons/HighContrast/16x16/actions/process-stop.png": "xkill", 
        "/usr/share/icons/HighContrast/16x16/status/audio-volume-high.png": "pavucontrol", 
        "/usr/share/icons/Humanity/status/16/stock_volume-max.svg": "amixer sset Master 1dB+", 
        "/usr/share/icons/Humanity/status/16/stock_volume-min.svg": "amixer sset Master 2dB-"
    }, 
    "surfmusik_lang": "EN", 
    "switch_channel": "bookmarks:favourite", 
    "switch_key": "XF86Forward", 
    "switch_random": false, 
    "timer_crontab": false, 
    "timer_duration": "auto", 
    "tmp": "/tmp/streamtuner2", 
    "useragent": "Streamtuner2", 
    "vtuner_order": "POP", 
    "vtuner_pages": "4", 
    "window_title": true, 
    "windows": false, 
    "windowsmedia_culture": "en-gb", 
    "xiph_source": "web", 
    "youtube_channels": "Key Of Awesome, Pentatonix", 
    "youtube_region": "GB", 
    "youtube_wadsworth": false
}

There are three JSON groups:

  • the plugins: { } list simply lists which channel and feature modules are enabled.
  • And record:
  • and player: are the audio/recording apps from the config dialog.

All other fields are individual core and plugin options. They're usually sorted alphabetically. Plugin options often have a name prefix which indicate their belonging.

You probably only want to edit it manually if there's a startup problem, which neither -D nor -d pluginoff can fix.

Hidden options

A few options may not be available in the F12 configuration dialog as checkbox, but can be edited here.

For example:

  • "cmd": "%s &", - exec wrapper string (see action.py)
  • "start_dir" - defined by workdir plugin
  • "firstrun"- set after first configuration
  • "dirble_api_key" - allows to set a custom user logon
  • "icon_dir" - deviced from ~/.config/streamtuner2/ directory

A few will be ovrriden on startup:

  • "windows" - current operating system
  • "firstrun"- set after first configuration

.netrc

A few plugins allow to provide a user login, but alternatively permit such options to be given in the standard location .netrc → which should look like:

 machine channel.com
     account me12345
     password pw12345

Where you may use either account or login for the username.