.TH TICKR 1 "May 23, 2013" .SH NAME .B Tickr - GTK-based highly graphically-customizable Feed Ticker. .SH SYNOPSIS .B tickr [\-help/\-version/\-license/\-instance\-id=n/\-no\-ui/\-dumpfontlist] .br [options (\-name[=value])...] [resource (file name or URL)] .SH DESCRIPTION .B Tickr is a GTK-based RSS/Atom Reader that displays feeds as a smooth scrolling line on your Desktop, as known from TV stations. Open feed links in your favourite Browser. Graphics are highly customizable. .SH OPTIONS .TP .B help Get help page .TP .B version Print out version number .TP .B license Print out license .TP .B instance\-id=n n = 1 to 99 - Use this when launching several instances simultaneously, each instance using its own config and dump files (to be effective, instance\-id must be the 1st argument) .TP .B no\-ui Disable opening of UI elements which can modify settings and/or URL list/selection .TP .B dumpfontlist Send list of available fonts to stdout .TP .B delay=n Delay in milliseconds .TP .B shiftsize=n Shift size in pixels .TP .B fgcolor=#rrggbbaa Foreground 32-bit hexa color .TP .B bgcolor=#rrggbbaa Background 32-bit hexa color .TP .B setgradientbg=[y/n] Set gradient background .TP .B bgcolor2=#rrggbbaa Background 32-bit hexa color2 .TP .B fontname='fontname' Font name .TP .B fontsize=n Font size (can't be > 200) .TP .B disablescreenlimits=[y/n] Allow win_y and win_w to be greater than screen dimensions .TP .B win_x=n Window position - x .TP .B win_y=n Window position - y .TP .B win_w=n Window width .TP .B win_h=n Window height (compute font size if > 0) .TP .B windec=[y/n] Window decoration .TP .B alwaysontop=[y/n] Window always-on-top .TP .B wintransparency=n Actually window opacity from 1 to 10 (0 = none -> 10 = full) .TP .B iconintaskbar=[y/n] Icon in taskbar .TP .B winsticky=[y/n] Visible on all user desktops .TP .B shadow=[y/n] Apply shadow to text .TP .B shadowoffset_x=n Shadow x offset in pixels .TP .B shadowoffset_y=n Shadow y offset in pixels .TP .B shadowfx=n Shadow effect (0 = none -> 10 = full) .TP .B linedelimiter='str' String to be appended at end of line .TP .B cutlinedelimiter='str' String to be appended after a cut line .TP .B specialchars=[y/n] Enable or disable special characters. This is only useful when resource is a file, not an URL .TP .B newpgchar=c \'New page' special character .TP .B tabchar=c \'Tab' (8 spaces) special character .TP .B rssrefresh=n Refresh rate in minutes (if no TTL inside feed / always applies for files) .TP .B feedtitle=[y/n] Show or hide feed title .TP .B feedtitledelimiter='str' String to be appended after feed title .TP .B itemtitle=[y/n] Show or hide item title .TP .B itemtitledelimiter='str' String to be appended after item title .TP .B itemdescription=[y/n] Show or hide item description .TP .B itemdescriptiondelimiter='str' String to be appended after item description .TP .B nitemsperfeed=n Read N items max per feed .TP .B rmtags=[y/n] Strip html tags .TP .B uppercasetext=[y/n] Set all text to upper case .TP .B homefeed='str' Set URL as 'homefeed' = homepage (from command line, not automatically saved, so a little bit useless...) .TP .B openlinkcmd='str' \'Open in Browser' command line: Application that will open active link (may require path.) Most likely will invoke your favourite browser .TP .B openlinkargs='str' \'Open in Browser' optional arguments .TP .B clock=[l/r/n] Clock location: left / right / none .TP .B clockfontname='fontname' Clock font name .TP .B clockfontsize=n Clock font size (can't be > ticker height) .TP .B clockfgcolor=#rrggbbaa Clock foreground 32-bit hexa color .TP .B clockbgcolor=#rrggbbaa Clock background 32-bit hexa color .TP .B setclockgradientbg=[y/n] Set clock gradient background .TP .B clockbgcolor2=#rrggbbaa Clock background 32-bit hexa color2 .TP .B disablepopups=[y/n] Disable error/warning popup windows .TP .B pauseonmouseover=[y/n] Pause ticker on mouseover .TP .B disableleftclick=[y/n] Disable left-click .TP .B mousewheelscroll=[s/f/n] Mouse wheel scrolling applies to: (ticker\-)speed / feed(\-in\-list) / none .br (if set, Ctrl + mouse wheel scrolling applies to other value) .TP .B sfpickercloseswhenpointerleaves=[y/n] Selected feed picker closes when pointer leaves .TP .B enablefeedordering=[y/n] Enable feed re-ordering (by user) .TP .B useauth=[y/n] Use HTTP basic authentication .TP .B user='str' User .TP .B psw='str' Password (never saved) .TP .B useproxy=[y/n] Connect through proxy .TP .B proxyhost='str' Proxy host .TP .B proxyport='str' Proxy port .TP .B useproxyauth=[y/n] Use proxy authentication .TP .B proxyuser='str' Proxy user .TP .B proxypsw='str' Proxy password (never saved) .SH NOTES Mouse usage: .PP - To open the main menu, right-click inside ticker area. .PP - You can import feed subscriptions from another feed reader with .br \'File > Import Feed List (OPML)'. .PP - To open a link in your browser, left-click on text. .PP - Use mouse wheel to either adjust ticker scrolling speed or open the \'Selected Feed Picker' window to quickly move between selected feeds (and use Ctrl + mouse wheel for the other option.) .PP The default browser is Firefox. You may change this setting to your favourite one in the Preferences window. .PP Tickr parses command line arguments and looks for option(s) then for one resource, the rest of the line is ignored. It reads too configuration file \'tickr-conf' located in /home//.tickr/ if it exists (or \'tickr-conf' if an instance id has been set to n.) See FILES. .PP Command line options override configuration file ones which override default ones. .SH FILES ~/.tickr/tickr-conf .br ~/.tickr/tickr-conf .br ~/.tickr/tickr-url-list .br ~/.tickr/tickr-url-list .SH REPORTING BUGS Please, report tickr bugs to either Emmanuel Thomas-Maurin or Debian. .SH AUTHOR .B Tickr was written by Emmanuel Thomas-Maurin . .PP This manual page was written by Emmanuel Thomas-Maurin , for the Debian project (and may be used by others).