{"id":27554309,"url":"https://github.com/masterevarior/gize","last_synced_at":"2026-05-07T11:31:46.544Z","repository":{"id":287350177,"uuid":"958034829","full_name":"MasterEvarior/gize","owner":"MasterEvarior","description":"📺 Display Git repositories through a website","archived":false,"fork":false,"pushed_at":"2025-04-17T19:44:40.000Z","size":135,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-18T17:37:16.870Z","etag":null,"topics":["direnv","docker","git","golang","nix-shell"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MasterEvarior.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-31T14:35:33.000Z","updated_at":"2025-04-12T18:06:20.000Z","dependencies_parsed_at":"2025-04-11T10:39:50.050Z","dependency_job_id":"8d433cac-6ffa-4df1-b69e-268472f46ef5","html_url":"https://github.com/MasterEvarior/gize","commit_stats":null,"previous_names":["masterevarior/gize"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterEvarior%2Fgize","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterEvarior%2Fgize/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterEvarior%2Fgize/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MasterEvarior%2Fgize/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MasterEvarior","download_url":"https://codeload.github.com/MasterEvarior/gize/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249715087,"owners_count":21314975,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["direnv","docker","git","golang","nix-shell"],"created_at":"2025-04-19T14:31:15.770Z","updated_at":"2026-05-07T11:31:46.539Z","avatar_url":"https://github.com/MasterEvarior.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gize\n\n![quality workflow](https://github.com/MasterEvarior/gize/actions/workflows/quality.yaml/badge.svg) ![release workflow](https://github.com/MasterEvarior/gize/actions/workflows/publish.yaml/badge.svg) ![Static Badge](https://img.shields.io/badge/Status-unmaintained-yellow)\n\nA lightweight web app to display your local Git repositories. Easily browse repo names, view metadata, and download ZIP archives on the fly.\n\nThis project was built for my own (admittedly narrow) use case: I wanted a simple way to display a list of Git repositories that are automatically backed up to my server. Tools like [GitLab](https://about.gitlab.com/) and [Forgejo](https://forgejo.org/) are great, but far too heavy for my needs as I am just using a fraction of their features. So, I made something leaner.\n\nThe name comes from the combination of the words \"Gaze\" and \"Git\".\n\n## Project Status\n\nI have since moved to [gogs](https://gogs.io/), which also fullfills my needs. Dependency updates and such will be merged, sometimes even a release will be created. I won't do new features though. If you want those, create a PR and I am happy to merge those.\n\n## Screenshots\n\n\u003cimg\nstyle=\"display: block;\nmargin-left: auto;\nmargin-right: auto;\nwidth: 100%;\"\nsrc=\"./images/screenshot.png\"\nalt=\"A screenshot, presenting the application\"\u003e\n\u003c/img\u003e\n\n## Build\n\nTo build the container yourself, simply clone the repository and then build the container with the provided docker file. You can the run it as described in the section below.\n\n```shell\ndocker build --tag gize .\n```\n\nAlternatively you can build the binary directly with Go.\n\n```shell\ngo build -o ./gize\n```\n\n## Run\n\nThe easiest way to run Gize, is to use the provided container.\n\n```shell\ndocker run -d \\\n  -e GIZE_ROOT=\"/repositories\" \\\n  -v ./path/to/your/repositories:/repositories \\\n  -p 8080:8080 \\\n  ghcr.io/masterevarior/gize:latest\n```\n\nYou should now see the UI at http://localhost:8080\n\n### Environment Variables\n\n| Name | Description | Default | Example | Mandatory |\n|------------------|------------------------------------------------------------|-----------------------------------------------------------------------------------------|---------------------|------------|\n| GIZE_ROOT | The Path to your directory where all your repositories are | | `/repositories` | ✅ |\n| GIZE_TITLE | Title that should be displayed | Gize | My cool title | ❌ |\n| GIZE_DESCRIPTION | Description that should be displayed under the title | Your local Git repository browser | My cool description | ❌ |\n| GIZE_FOOTER | Content of the footer, this allows for HTML | Made with ❤️ and published on \u003ca href='https://github.com/MasterEvarior/gize'\u003eGitHub\u003c/a\u003e| My cool footer | ❌ |\n| GIZE_PORT | Port | `:8080` | `:8455` | ❌ |\n| GIZE_ENABLE_DOWNLOAD | Wether or not to enable the ability to download a repository as a ZIP | `false` |`true` | ❌ |\n| GIZE_ENABLE_CACHE | Wether or not to enable a simply in-memory cache to speed up subsequent loads. The livetime is 300s by default. | `false` |`true` | ❌ |\n\n## Deployment\n\nWith Docker compose:\n\n```yaml\nservices:\n  gize:\n    image: ghcr.io/masterevarior/gize:latest\n    ports:\n      - \"8080:8080\"\n    environment:\n      - GIZE_ROOT=/repositories\n    volumes:\n      - ./path/to/your/repositories:/repositories\n    restart: unless-stopped\n```\n\n## Development\n\n### Linting\n\nLinting is done with [golangci-lint](https://golangci-lint.run/), which can be run like so:\n\n```shell\ngolangci-lint run\n```\n\nRun all other linters with the treefmt command. Note that the command does not install the required formatters.\n\n```shell\ntreefmt\n```\n\n### Git Hooks\n\nThere are some hooks for formatting and the like. To use those, execute the following command:\n\n```shell\ngit config --local core.hooksPath .githooks/\n```\n\n### Nix\n\nIf you are using [NixOS or the Nix package manager](https://nixos.org/), there is a dev shell available for your convenience. This will install Go, everything needed for formatting, set the Git hooks and some default environment variables. Start it with this command:\n\n```shell\nnix develop\n```\n\nYou can also build, test and start the application with nix.\n\n```shell\n# Build the gize binary\n# The resulting binary will be in ./result/bin/gize\nnix build\n\n# Run the application directly\n# This uses the environment variables from the dev shell\nnix run\n\n# Run all checks (tests and formatting)\nnix flake check\n\n# Build the container image\n# The resulting image tarball will be in ./result\nnix build .#image\n\n# Run the application inside a Docker container\n# This builds, loads, and runs the container via Docker\nnix run .#image\n```\n\nIf you happen to use [nix-direnv](https://github.com/nix-community/nix-direnv), this is also supported.\n\n## Improvements, issues and more\n\nPull requests, improvements and issues are always welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterevarior%2Fgize","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmasterevarior%2Fgize","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmasterevarior%2Fgize/lists"}