OptionsOn gource itself
-h--help
Help ('-H' for extended help)
--viewport
Set the viewport size. If -f is also supplied, will attempt to set the video mode to this also. Add `!` to make the window non-resizable <size>
--screen
Set the number of the screen to display on <screen>
--high-dpi
Request a high DPI display when creating the window. On some platforms such as MacOS, the window resolution is specified in points instead of pixels. The --high-dpi flag may be required to access some higher resolutions. E.g. requesting a high DPI 800x600 window may produce a window that is 1600x1200 pixels
--window-position
Initial window position on your desktop which may be made up of multiple monitors. This will override the screen setting so don't specify both <position>
--frameless
Frameless window
--transparent
Make the background transparent. Only really useful for screenshots
--start-date
Start with the first entry after the supplied date and optional time. If a time zone offset isn't specified the local time zone is used. Example accepted formats: 'YYYY-MM-DD', 'YYYY-MM-DD hh:mm', 'YYYY-MM-DD hh:mm:ss +tz' <date>
--stop-date
Stop at the last entry prior to the supplied date and optional time. Uses the same format as --start-date <date>
-p--start-position
Begin at some position in the log (between 0.0 and 1.0 or 'random') <position>
--stop-position
Stop (exit) at some position in the log (does not work with STDIN) <position>
-t--stop-at-time
Stop (exit) after a specified number of seconds <seconds>
--stop-at-end
Stop (exit) at the end of the log / stream
--loop
Loop back to the start of the log when the end is reached
--loop-delay-seconds
Seconds to delay before looping <seconds>
-a--auto-skip-seconds
Automatically skip to next entry if nothing happens for a specified number of seconds <seconds>
-s--seconds-per-day
Speed of simulation in seconds per day <seconds>
--realtime
Realtime playback speed
--no-time-travel
Use the time of the last commit if the time of a commit is in the past
-c--time-scale
Change simulation time scale
-i--file-idle-time
Time in seconds files remain idle before they are removed or 0 for no limit
--file-idle-time-at-end
Time in seconds files remain idle at the end before they are removed <seconds>
-e--elasticity
Elasticity of nodes <elasticity>
-b--background-colour
Background colour in hex <colour>
--background-image
Set a background image <image file>
--title
Set a title <title>
--font-file
Specify the font. Should work with most font file formats supported by FreeType, such as TTF and OTF, among others <font file>
--font-scale
Scale the size of all fonts <scale>
--font-size
Font size used by the date and title <size>
--file-font-size
Font size of filenames <size>
--dir-font-size
Font size of directory names <size>
--user-font-size
Font size of user names <size>
--font-colour
Font colour used by the date and title in hex <colour>
--key
Show file extension key
--logo
Logo to display in the foreground <image file>
--logo-offset
Offset position of the logo <offset>
--date-format
Specify display date string (strftime format) <format>
--log-command
Show the log command used by gource (git,svn,hg,bzr,cvs2cl) <command>
--log-format
Specify format of the log being read (git,svn,hg,bzr,cvs2cl,custom). Required when reading from STDIN <format>
--git-branch
Get the git log of a branch other than the current one <branch>
--follow-user
Have the camera automatically follow a particular user <username>
--highlight-dirs
Highlight the names of all directories
--highlight-user
Highlight the names of a particular user <username>
--highlight-users
Highlight the names of all users
--highlight-colour
Font colour for highlighted users in hex <colour>
--selection-colour
Font colour for selected users and files <colour>
--filename-colour
Font colour for filenames <colour>
--dir-colour
Font colour for directories <color>
--dir-name-depth
Draw names of directories down to a specific depth in the tree <depth>
--dir-name-position
Position along edge of the directory name (between 0.1 and 1.0, default is 0.5) <position>
--filename-time
Duration to keep filenames on screen (>= 2.0) <time>
--file-extensions
Show filename extensions only
--file-extension-fallback
Use filename as extension if the extension is missing or empty
--file-filter
Filter out file paths matching the specified regular expression <regex>
--file-show-filter
Show only file paths matching the specified regular expression <regex>
--user-filter
Filter usernames matching the specified regular expression <regex>
--user-show-filter
Show only usernames matching the specified regular expression <regex>
--user-image-dir
Directory containing .jpg or .png images of users (eg 'Full Name.png') to use as avatars <directory>
--default-user-image
Path of .jpg to use as the default user image <User image>
--fixed-user-size
Forces the size of the user image to remain fixed throughout
--colour-images
Colourize user images
--crop
Crop view on an axis (vertical,horizontal) <axis>
--padding
Camera view padding <padding>
--multi-sampling
Enable multi-sampling
--bloom-multiplier
Adjust the amount of bloom <multiplier>
--bloom-intensity
Adjust the intensity of the bloom <intensity>
--max-files
Set the maximum number of files or 0 for no limit. Excess files will be discarded <number>
--max-file-lag
Max time files of a commit can take to appear. Use -1 for no limit <seconds>
--max-user-speed
Max speed users can travel per second <units>
--user-friction
Time users take to come to a halt <seconds>
--user-scale
Change scale of user avatars <scale>
--camera-mode
Camera mode (overview,track) <mode>
--disable-auto-rotate
Disable automatic camera rotation
--disable-input
Disable keyboard and mouse input
--hide
Hide one or more display elements from the list below: bloom - bloom effect date - current date dirnames - names of directories files - file icons filenames - names of files mouse - mouse cursor progress - progress bar widget root - root directory of the tree tree - animated tree structure users - user avatars usernames - names of users <element>
--hash-seed
Change the seed of hash function <seed>
--caption-file
Caption file (see Caption Log Format) <file>
--caption-size
Caption size <size>
--caption-colour
Caption colour in hex <colour>
--caption-duration
Caption duration <seconds>
--caption-offset
Caption horizontal offset (0 to centre captions) <offset>
-o--output-ppm-stream
Output a PPM image stream to a file ('-' for STDOUT). This will automatically hide the progress bar initially and enable 'stop-at-end' unless other behaviour is specified <file>
-r--output-framerate
Framerate of output (25,30,60). Used with --output-ppm-stream <fps>
--output-custom-log
Output a custom format log file ('-' for STDOUT) <file>
--load-config
Load a config file <config file>
--save-config
Save a config file with the current options <config file>
--path
Either a supported version control directory, a pre-generated log file (see log commands or the custom log format), a Gource conf file or '-' to read STDIN <path>
