Doesn't seem to run

[GiantLuigi4]

So I'm trying to run this, but it just instantly closes. I've tried command prompt, a .cmd file, the .exe file, none of them actually seem to do anything. The closest I've gotten was getting a window to open up for a frame and then just close. Hope you can help me.

[acaudwell]

It's command line driven, so in command prompt you either need to cd to the source code directory you want to visualize and run gource or specify the path of that directory gource c:\my\source\repo\.

If that doesn't work it should be printing out a message to the command prompt telling you what went wrong.

[GiantLuigi4]

I did do that, and it doesn't give any form of info as to what's wrong. Just opens a window (which I assume is gource) for a frame, and then closes it. I can't find any information on how to do anything required to run this on a github project or anything else.

[jessycormier]

it seems to me you're not targeting a git repo so the 1 frame you're seeing is literally the program running successfully. There's a ton of information in this repo about the controls available and how to run it try exploring a bit to see if you can get it working.

[GiantLuigi4]

I did read through that info, but I have no idea what it means. I have no understanding of how to use github other than for issues and opening a repo.

[jessycormier]

Okay, well Gource will let you visualize a git repo (not just github but any git repository you have on your PC)

Get started by installing gource to your machine. Next download or clone a repository. I'll suggest this: https://github.com/denoland/deno

You can find the download on the right-hand side of the web page in a button with "clone or download".

Once you have that on your computer, let's assume your Desktop, you'll want to open up command prompt (CMD) shell and navigate to the folder you downloaded (or cloned).

C:\Users\XYZ\Desktop\deno\

now run gource in that folder.

If you get access denied warning then you may have to use the current workaround I was able to track down in the issues. https://github.com/acaudwell/Gource/issues/100

What that issue shows is you can generate your own git log to use instead of letting gource build it.

Taking a sample from that you can do something along the lines of this

git log --pretty=format:user:%aN%n%ct --reverse --raw --encoding=UTF-8 --no-renames >> gitcommits.log

which will create a file called gitcommits.log in the directory you're in.

Next run gource gitcommits.log to get the visualizations working.

If you want to tweak how the visualizations work then read the wiki on controls. You'll just add the commands to see them in action, for example, to speed to the visual logging you could use

gource gitcommits.log --seconds-per-day 0.25

See if you can get it going now. Good luck!

[2234839]

Okay, well Gource will let you visualize a git repo (not just github but any git repository you have on your PC)

Get started by installing gource to your machine. Next download or clone a repository. I'll suggest this: https://github.com/denoland/deno

You can find the download on the right-hand side of the web page in a button with "clone or download".

Once you have that on your computer, let's assume your Desktop, you'll want to open up command prompt (CMD) shell and navigate to the folder you downloaded (or cloned).

C:\Users\XYZ\Desktop\deno\

now run gource in that folder.

If you get access denied warning then you may have to use the current workaround I was able to track down in the issues. #100

What that issue shows is you can generate your own git log to use instead of letting gource build it.

Taking a sample from that you can do something along the lines of this

git log --pretty=format:user:%aN%n%ct --reverse --raw --encoding=UTF-8 --no-renames >> gitcommits.log

which will create a file called gitcommits.log in the directory you're in.

Next run gource gitcommits.log to get the visualizations working.

If you want to tweak how the visualizations work then read the wiki on controls. You'll just add the commands to see them in action, for example, to speed to the visual logging you could use

gource gitcommits.log --seconds-per-day 0.25

See if you can get it going now. Good luck!

The results of my attempts are as follows

❯ git log --pretty=format:user:%aN%n%ct --reverse --raw --encoding=UTF-8 --no-renames 
>> gitcommits.log
❯ gource gitcommits.log
gource: unsupported log format (you may need to regenerate your log file)
Try 'gource --help' for more information.

solution https://github.com/acaudwell/Gource/issues/100#issuecomment-577775162