← 返回命令列表

Linux command

gource 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Visualize current repo

gource

Visualize specific repo

gource [/path/to/repo]

Run in fullscreen mode

gource -f

Output PPM stream and pipe to ffmpeg for video

gource -1280x720 -o - | ffmpeg -y -r 60 -f image2pipe -vcodec ppm -i - -vcodec libx264 -pix_fmt yuv420p [output.mp4]

Set time scale

gource --seconds-per-day [0.1]

Hide specific elements

gource --hide filenames,mouse,progress

Visualize with a date range

gource --start-date "[2024-01-01]" --stop-date "[2024-12-31]"

说明

gource visualizes version control history as an animated tree. Developers appear as avatars making changes, with files and directories branching from the center in a real-time animation. The tool supports Git, SVN, Mercurial, and Bazaar repositories. Output can be piped to video encoders like ffmpeg for creating shareable recordings of project history.

参数

-o, --output-ppm-stream _FILE_
Output PPM image stream to file ('-' for stdout). Used with ffmpeg for video creation.
-r, --output-framerate _FPS_
Framerate of output (25, 30, 60). Used with --output-ppm-stream.
-WIDTHxHEIGHT, --viewport _WIDTHxHEIGHT_
Set viewport size (e.g., 1280x720).
--seconds-per-day _SEC_
Time in seconds for each day of history (default: 10).
--hide _ELEMENTS_
Hide display elements (comma-separated): bloom, date, dirnames, files, filenames, mouse, progress, root, tree, users, usernames.
--start-date _DATE_
Start at a date (YYYY-MM-DD format).
--stop-date _DATE_
Stop at a date.
-f, --fullscreen
Fullscreen mode.
--title _TITLE_
Set a title.
--load-config _FILE_
Load a configuration file.
--save-config _FILE_
Save current options to a configuration file.
-h, --help
Display help information.

FAQ

What is the gource command used for?

gource visualizes version control history as an animated tree. Developers appear as avatars making changes, with files and directories branching from the center in a real-time animation. The tool supports Git, SVN, Mercurial, and Bazaar repositories. Output can be piped to video encoders like ffmpeg for creating shareable recordings of project history.

How do I run a basic gource example?

Run `gource` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does -o, --output-ppm-stream _FILE_ do in gource?

Output PPM image stream to file ('-' for stdout). Used with ffmpeg for video creation.