com.semchyshyn:opart

Yuriy's tools for algorithmic generation of optical art pieces (still and animated).

Overview

This repository contains a personal passion project with no significance whatsoever. You should probably go back to wherever you came from. It is extremely unlikely that you actually need any of this.

But hey, if you're still here — welcome! Look around and feel free to take whatever you want. The whole thing has been dedicated to the public domain under Creative Commons' CC0 license.

No pull request will be approved under any circumstances. You should reach out to Yuriy directly if this feels wrong. Or if you want to discuss anything else, really.

Setup

1. Integrated Development Environment

   As of late 2025, however sad it might be to admit, IntelliJ IDEA seems to be the best available option, as far as Java IDEs are concerned.

   • Microsoft's Visual Studio Code is compact, well-integrated, and has an acceptable UI; but fails to properly handle Java even after extensive customization.
   • Eclipse Foundation's Eclipse still offers adequate capabilities with a reasonable UI; but has also become somewhat bloated while still requiring manual installation of tools.
   • Apache's NetBeans looks as awesome as ever with its beautifully clean UI; but seriously lacks in capabilities and does not quite work out-of-the-box.
   • JetBrains' IntelliJ IDEA has a godawful UI and comes atrociously misconfigured by default; yet it is extremely powerful, just works immediately upon installation, and even takes care of pulling all the necessary tools up (JDK, Maven, Git, MinGW).

   It is indeed utterly terrifying how Russia's ФСБ/СВР (Federal Security and Foreign Intelligence Services) can now take control of literally everything on a whim… But what can one do, aside from watching the world learn from its mistakes?

   So yeah, go ahead and get yourself the most recent version of IntelliJ IDEA.

2. Version Control System

   Configure Git by executing the following commands

   git config --global user.name "John Doe"
   git config --global user.email jdoe@example.org
   git config --global core.editor edit

3. Authentication and Authorization

   After executing the following commands

   ssh-keygen -t rsa -b 16384 -a 1 -C jdoe@example.org
   
   git config --global commit.gpgsign true
   git config --global gpg.format ssh
   git config --global user.signingkey %UserProfile%\.ssh\id_rsa

   post the content of %UserProfile%\.ssh\id_rsa.pub to GitHub twice (yay for usability!)

4. Source Code Repository

   Create a local copy of the repository by executing the following command

   git clone git@github.com:5/opart.git OpArt

Workflow

5. Change

   Introduce a change to the project.

6. Execute

   Validate the change by creating a new piece of optical art.

7. Commit

   Store the change to GitHub by executing the following command

   git add --all && git commit --amend --no-edit && git push --force

8. Clean Up

   Executing the following command from time to time prunes unnecessary metadata from the repository

   git reflog expire --expire=all --all --expire-unreachable=now