https://github.com/sorairolake/pagen
Generate pixel art from random numbers
https://github.com/sorairolake/pagen
cli command-line command-line-tool go golang pixel-art pixelart terminal tool
Last synced: about 2 months ago
JSON representation
Generate pixel art from random numbers
- Host: GitHub
- URL: https://github.com/sorairolake/pagen
- Owner: sorairolake
- License: cc0-1.0
- Created: 2025-05-13T13:04:26.000Z (about 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-05-13T13:34:49.000Z (about 1 year ago)
- Last Synced: 2025-05-13T14:50:28.715Z (about 1 year ago)
- Topics: cli, command-line, command-line-tool, go, golang, pixel-art, pixelart, terminal, tool
- Language: Go
- Homepage: https://pkg.go.dev/github.com/sorairolake/pagen
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.adoc
- Contributing: CONTRIBUTING.adoc
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS.adoc
Awesome Lists containing this project
README
# pagen
[![CI][ci-badge]][ci-url]
[![Go Reference][reference-badge]][reference-url]
![Go version][go-version-badge]
**pagen** is a command-line utility for generating pixel art written in [Go].
The value of each pixel is determined from random numbers.
## Installation
### From source
```sh
go install github.com/sorairolake/pagen@latest
```
### From binaries
The [release page] contains pre-built binaries for Linux, macOS, Windows and
others.
### How to build
Please see [BUILD.adoc].
## Usage
### Basic usage
```sh
pagen -width 1280 -height 720 -block-size 80 output.png
```
Here is an example of generated pixel art:

### Generate as a SVG image
```sh
pagen -width 1280 -height 720 -block-size 80 -svg output.svg
```
Here is an example of generated pixel art:

## Source code
The upstream repository is available at
.
## Changelog
Please see [CHANGELOG.adoc].
## Contributing
Please see [CONTRIBUTING.adoc].
## License
Copyright (C) 2025 Shun Sakai (see [AUTHORS.adoc])
This program is distributed under the terms of the _CC0 1.0 Universal_.
This project is compliant with version 3.3 of the [_REUSE Specification_]. See
copyright notices of individual files for more details on copyright and
licensing information.
[ci-badge]: https://img.shields.io/github/actions/workflow/status/sorairolake/pagen/CI.yaml?branch=develop&style=for-the-badge&logo=github&label=CI
[ci-url]: https://github.com/sorairolake/pagen/actions?query=branch%3Adevelop+workflow%3ACI++
[reference-badge]: https://img.shields.io/badge/Go-Reference-steelblue?style=for-the-badge&logo=go
[reference-url]: https://pkg.go.dev/github.com/sorairolake/pagen
[go-version-badge]: https://img.shields.io/github/go-mod/go-version/sorairolake/pagen?style=for-the-badge&logo=go
[Go]: https://go.dev/
[release page]: https://github.com/sorairolake/pagen/releases
[BUILD.adoc]: BUILD.adoc
[CHANGELOG.adoc]: CHANGELOG.adoc
[CONTRIBUTING.adoc]: CONTRIBUTING.adoc
[AUTHORS.adoc]: AUTHORS.adoc
[_REUSE Specification_]: https://reuse.software/spec-3.3/