StreamBabyIni

streambaby.ini options

Note: Unlike standard Java property files, streambaby.ini files support the use of the blackslash character without a prefix. This means that windows directories can (and should) be specified as c:\my data\my videos and not c:\\my data\\my videos.

Consult [QualitySettings] for streambaby quality settings

dir.x=yyyyyy

• Specifies directories that StreamBaby will look for movies/videos in.
• Example:
  dir.1=C:\Users\Kevin\Videos
dir.1.name=Kevin videos
dir.2=C:\movies
dir.2.name=System Movies
• Passwords can also be specified. So to allow the password roger or tomcat to access dir.1, and anyone to access dir.2 (assuming password= is not set)
  dir.1=C:\Users\Kevin\Videos
dir.1.name=Kevin Videos
dir.1.password=roger,tomcat
dir.2=C:\movies
dir.2.name=System Movies

ignore.names=name1,name2 (default:blank)

• A comma separated list of file or directory names to ignore when scanning the directory hierarchy of shares.
• Note that the names to ignore can either be full strings or regex expressions.
• EXAMPLES:
  • Ignore "Star Wars" and "Sons of Tucson" titles:
    ignore.names=Star Wars,Sons of Tucson
  • Ignore any title with "Wars" string and "Sons of Tucson" titles:
    ignore.names=(.*)Wars(.*),Sons of Tucson

tivo.MAK= (default:none)

Used along with tdcat utility to obtain metadata information from your .TiVo files. Without supplying MAK there will be no metadata displayed for .TiVo files. Also used to stream Program Stream container .TiVo files using tivodecode.

tdcat.path= (default:native/tdcat)

Specify location of tdcat executable which is used to obtain metadata information from .TiVo files along with your supplied MAK.

tivodecode.path= (default:native/tivodecode)

Specify location of tivodecode executable which is used to decrypt Program Stream container .TiVo files along with your supplied MAK. NOTE: Make sure you specify tivo.MAK in your streambaby.ini file.

tivo.username= (default:none)

tivo.password= (default:none)

allows TiVo to push videos to your TiVo's instead of streaming.
Should be set to username+password of you tivo.com account

password= (default:none)

default password list for directories (comma seperated)

trimextensions= (default:false)

Trim extensions from filenames when displaying

extensions= (default:mp4,mpeg,vob,mpg,mpeg2,mp2,avi,wmv,asf,mkv,tivo,m4v,raw,3gp,mov,flv,ts,wtv,m2ts)

Extensions to scan for when listing files

port= (default:7290)

HME port to attach to

ip= (default:none)

IP address to bind HME to. Java is not always able to correctly determine the IP of the computer it's running on, so it may be necessary to manually specify the IP.

title= (default:streambaby)

Title to use for HME

preview.quality= (default:10)

jpeg quality for preview (1-100, 1=lowest/100=highest)

preview.big= (default:false)

use full screen for preview (otherwise it is thumbnailed like netfilix) thumbnail is default.

mdns.disable= (default:false)

Disable mDNS

mp4module.interleave= (default:true)

enable re-interleaving of mp4s

lib.native= (default:/home/keary/twork/streambaby/native)

path to look for native libraries

transcode.disable= (default:false)

disable transcoding for incompatible video streams

tmp.path= (default:OS standard tmp path)

Temporary files path

preview.disable= (default:0)

* 0=Don't disable
* 1=Disable, but show window with time during ffwd/rewind in previewmode
* 2=Disable completely, only move shuttle bar during preview

preview.displaytime= (default:true)

Display the time over the preview image when ffwding/rwding

preview.cache= (default:cache)

Directory to look for (and possibly store) static pvw files

preview.autogenerate= (default:true)

Autogenerate static pvw files when file is played for first time

autogenerate.continue= (default:true)

continue autogeneration of previews, even when movie stopped

autogenerate.delete= (default:false)

deletes preview files when the original file can no longer be found

player.pleasewait= (default:true)

Shows pleaseWait graphic when seeking. If disabled shows text

Selection Screen parameters

browser.image.height= (default:180)

Height to use for selection screen image art

streambaby.use_sideview= (default:true)

Use side view on selection screen to show details of selected entry

use.title= (default:true)

If false then display file names instead of titles

sort.filename= (default:false)

If true then sort displayed entries by alphabetic file name instead of alphabetic title.

sort.date= (default:false)

If true then sort displayed entries by file last modified date instead of alphabetical.

Video playback display related parameters

display.timeout_status_bar= (default:5)

Number of seconds for status bar to timeout

display.timeout_icon= (default:5)

Number of seconds for icon display to timeout

display.timeout_info= (default:10)

Number of seconds for program information to timeout

display.skip_backwards= (default:8)

Number of seconds for skip backwards

display.skip_forwards= (default:30)

Number of seconds for skip forwards

Video Module features/arguments enable/disable

Note: Streambaby has the concept of video modules. There are currently 3 video modules.

• built-in mp4 streamer module
• built-in mpeg streamer module
• tivo file streamer module
• ffmpegexe module which runs ffmpeg.exe as an external process for transcoding and generating pvw thumbnail files.
  The options below specify various configuration settings for the various modules.

ffmpeg.path= (default:ffmpeg or native/ffmpeg.exe for win32)

path of ffmpeg

mp4module.disable= (default:false)

Disable built-in mp4 streaming module

mpegmodule.disable= (default:false)

Disable built-in mpeg streaming module

mp4mod.fillvidinfo= (default:true)

Allow mp4module to parse video informaton

mp4mod.streamformats= (default:MP4 files with h264/aac/ac3 format)

list of formats mp4module should attempt to stream

mp4mod.streamformats.disallow= (default:default)

list of formats mp4module should not attempt to stream

mp4mod.maxlevel= (default:51)

Maximum allowed H264 level for native mp4 streaming. Anything higher than this will be transcoded to mpeg2. Series 3 TiVos may have to be set this to 41 since I don't believe they support anything higher than 41.

mpegmod.fillvidinfo= (default:true)

Allow mpegmodule to parse video informaton

mpegmod.streamformats= (default:mpeg,mpv2,*)

list of formats mpegmodule should attempt to stream

mpegmod.streamformats.disallow= (default:none)

list of formats mpegmodule should not attempt to stream

ffmpegexe.transcode.mime= (default:video/mpeg)

mimetype to use when transcoding from ffmpeg

ffmpegexe.preview= (default:-r 1 -f mjpeg -v 0)

Arguments to use when generating previews from ffmpeg.exe (for pvw file generation)

ffmpegexe.previewformats= (default:all containers, all formats)

list of formats the ffmpegexe module should attempt to preview

ffmpegexe.previewformats.disallow= (default:*,none,*)

list of formats ffmpegexe should not attempt to preview

ffmpegexe.transcodeformats= (default:all)

list of formats the ffmpegexe module should attempt to transcode

ffmpegexe.transcodeformats.disallow= (default:*,none,*;mpeges,*,*)

list of formats ffmpegexe should not attempt transcode (defaults to any file with no video, or mpeges streams)

sockets.start= (default:8500)

Socket start for internal socket use

sockets.count= (default:500)

Number of sockets to use for internal socket use

How to specify video formats in the ini file

Note: When specifying "formats', the format is specified as container,videocodec,audiocodec

• To specify multiple format, seperate them with a semi-colon A * is a wildcard
• Possible containers: mp4,avi,mkv,mpeg,mpegts,wmv,mpeges
• Possible videocodecs: h264,mp2v,mp1v,vc1,none
• Possible audiocodecs: mp2,ac3,aac,mp3,wma2,none

ffmpeg_transcoding_configuration

Note: The following "parameters" can be used within the ffmpegexe arguments:

• closest.mpeg.fps= The closest frame rate of the original video to a legal mpeg frame rate
• bitrate=The video bitrate to transcode to
• abitrate=The audio bitrate to transcode to
• xres=The x resolution to transcode to
• yres=The y resolution to transcode to

transcode.bufferlimit= (default:20)

The maximum buffer size in GB allowed for transcoding videos or for videos whose file size is undetermined

ffmpegexe.transcode= (default:-acodec ac3 -vcodec mpeg2video -f vob -async 1 -r ${closest.mpeg.fps} -v 0)

Arguments to use when transcoding from ffmpeg

ffmpegexe.transcode.sameqargs (default: -qscale 0 -ab 192k)

The arguments to add to the transcode line when transcoding to the same quality as the original. This is also used if quality selection is turned off (assuming quality.default=same, which is also default)

ffmpegexe.transcode.qualargs (default: -bufsize 4096k -b ${bitrate}k -maxrate 8000k -ab ${abitrate}k -s ${xres}x${yres})

The arguments to add the transcode line when transcoding to a specific audio/video bitrate.

Advanced Options

Options that may or may not have the desired effect, and are mainly for debugging/experimental. Touching these may break everything.

preview.threaded= (default:true)

Use threads to generate preview frames

preview.predictive= (default:false)

Attempt to predict which frame will be previewed next, and pre-generate it

autogenerate.background= (default:0)

minutes to check for files to autogenerate previews in the background 0=disabled. If this is set, all movies will be scanned and those movies that are determined not to support real-time preview generation, thumbnail files will be generated.

Closed Captioning Options

cc.minchartime=50

Minimum time to leave a CC on the screen (per character) in ms

cc.mintime=1500

Minimum time to leave a CC on the screen (absolute) in ms

cc.fontsize=small

Size of font as either absolute integer, or medium, small, tiny

cc.yoff=24

Offset from bottom for CC

cc.background.transparency=0.25

CC background transparency (0=>off)

cc.background=1===

CC background (1=>on 0=>off)

cc.backgroundcolor=black

CC background color

cc.textcolor=white

CC text color

PLEX RELATED OPTIONS - EXPERIMENTAL !!

plex.server=IP:port (default:none)

If you specify the IP and port of a Plex Media Server on your home network then streambaby will connect to the server and build a "Plex" top level folder along with corresponding Plex video libraries.
NOTE: This feature is new and experimental and may not be function correctly for your Plex setup.

---

newV020

Consult [QualitySettings] for streambaby quality settings

icon.icon

icon.movie

icon.folder

Set to PNG files to represent the icons to use for the streambaby application icon, folder icon, and movie icon. files are relative to the assets directory.

background.image

Set to point to the PNG file to use for the background

ignore.dotfiles (default: true)

Set to true if you want files/folders beginning with a dot to show up in selection screen.

remember.password (default: true)

Set to false to not cache passwords on a tivo by tivo basis

toplevel.skip (default: false)

Set to true to skip the "Top Level" folder screen if there is only one folder

streambaby.dir

Set this to manually specify where the streambaby main directory is

cut.startoffset (default: 0)

cut.endoffset (default: 0)

When using an EDL file to mark "cut" positions (commercial skipping) offset the start and end points by this many milliseconds. So if startoffset is set to 500 and endoffset is set to 1000 the jump will be made 1/2 second after the cutpoint specified, and it will jump to 1 second before the end of the cutpoint

[Bill Kearney]

If you set up a directory with a password and it doesn't appear, press the (Clear) button on your Tivo remote. That will bring up the password entry screen. It'd help if this was added as a comment in the INI instructions/file.