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.