cryptopunks-gui

CryptoPunks GUI 0.0.15

Simplified Image Generation

This is a Graphical User Interface for the cryptopunks Ruby gem.

It automatically downloads image collection sprites on first use (e.g. punks.png from https://github.com/larvalabs/cryptopunks).

Generated cryptopunks are stored at ~/cryptopunks/ by default (output location can be changed).

Prerequities

• Tcl/Tk (ActiveTcl 8.6)
• RVM (unless you are on Windows)
• Ruby 3.0.2 compiled with RVM for Tk (unless you are on Windows for which Tcl/Tk instructions include installation of Ruby [get v3.0.2])

Here are more detailed instructions for installing the prerequisites on every platform:

Mac:

• Install the ActiveTcl 8.6 Mac package from ActiveState.com
• Install RVM by running \curl -sSL https://get.rvm.io | bash -s stable (and run curl -sSL https://rvm.io/pkuczynski.asc | gpg --import - if needed for mentioned security reasons)
• Run: rvm install 3.0.2 --enable-shared --enable-pthread --with-tk --with-tcl
• Run: gem install tk -v0.4.0

Windows:

• Install Ruby+Devkit (including MSYS/MINGW toolchains) through Windows Installer: https://rubyinstaller.org/downloads/
• Install the ActiveTcl 8.6 Windows package from ActiveState.com
• Follow this instruction: "First, Ruby needs to find the tcl86t.dll and tk86t.dll shared libraries. These are located in C:\ActiveTcl\bin. Make a copy of them somewhere Ruby can find them, e.g. C:\Ruby26\bin."
• Setup environment variables TCL_LIBRARY=C:\ActiveTcl\lib\tcl8.6 & TK_LIBRARY=C:\ActiveTcl\lib\tk8.6
• Run: gem install tk -v0.4.0

Linux:

• Download the ActiveTcl 8.6 Linux package from ActiveState.com
• Extract the tar gz file using command tar zxvf ActiveTcl-version-number.tar.gz
• Run included install shell script ./ActiveTcl-version-number/install.sh
• Install RVM by running \curl -sSL https://get.rvm.io | bash -s stable (and run curl -sSL https://rvm.io/pkuczynski.asc | gpg --import - if needed for mentioned security reasons)
• Run: rvm install 3.0.2 --enable-shared --enable-pthread --with-tk --with-tcl
• Run: gem install tk -v0.4.0

Setup

You can use CryptoPunks GUI via gem or via cloning repository (if you encounter any issues, please try older versions of the gem and report the issues encountered).

Gem

Run:

$ gem install cryptopunks-gui -v0.0.15

Afterwards, run app via:

$ cryptopunks-gui

Repository

Clone repository:

$ git clone https://github.com/cryptopunksnotdead/cryptopunks-gui.git

Enter directory:

$ cd cryptopunks-gui

Run:

$ gem install bundler
$ bundle

Afterwards, run app via:

$ bin/cryptopunks-gui

Alternatively, run app manually via:

$ ruby app/cryptopunks_gui.rb

Instructions

Collection

Change collection to pick a different collection of images.

Image collections are configured in cryptopunks-collections.yml.

If you cloned the project locally, you may edit cryptopunks-collections.yml to add/remove collections.

There are 41 available collections (mostly from https://github.com/cryptopunksnotdead/awesome-24px):

• Punks
• Mohawks
• Blondies
• Zombies
• Apes
• Aliens
• Golden Punks
• Green Punks
• Clown Punks
• Bubble Gum Punks
• Halloween Punks
• Scream Punks
• Jack 'O' Lantern Punks
• Joker Punks
• Frankenstein Punks
• Front Punks
• More Punks
• Expansion Punks
• Avalanche Punks
• International Punks
• Ape Punks
• Alien Clan
• Bored Apes
• Bored Apes Blue
• Bored Apes Red
• Bored Apes Neon Glow
• Bored Apes Stars and Stripes
• Bored Apes Acid
• Cool Cats
• Cool Cats Mohawks
• Cool Cats Ninjas
• Cool Cats TV Heads
• Cool Cats Pirates
• Cool Cats Unicorns
• Cool Cats Dragons
• Cool Cats Frogs
• Pudgy Penguins
• Doge
• Rocks
• Punk Rocks
• Tulips

Image Index

Change image index to pick a different image.

Zoom

Change zoom to enlarge punk to your liking.

Palette

Change palette to get different punk colors.

Style

Change style to get different punk looks.

Normal Style

Led Style

Led Spacing

Led Round Corner

Sketch Style

Sketch Line

Mirror/Flip

Check mirror and/or flip to apply punk transformations. Can be combined with different palettes and styles.

Output Location

You may select a new output location by clicking on the ... button.

TODO

TODO.md

Change Log

CHANGELOG.md

Contributing

• Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
• Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
• Fork the project.
• Start a feature/bugfix branch.
• Commit and push until you are happy with your contribution.
• Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
• Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

License

The cryptopunks-gui scripts are dedicated to the public domain. Use it as you please with no restrictions whatsoever.

---

Built with Glimmer DSL for Tk (MRI Ruby Desktop Development GUI Library)