README.md

@@ -0,0 +1,44 @@
+# PLAYSCII - an ASCII art and game creation tool
+
+Playscii (pronounced play-skee) is an art, animation, and game creation tool.
+The latest version will always be available here:
+
+* [http://jp.itch.io/playscii](http://jp.itch.io/playscii)
+* [https://heptapod.host/jp-lebreton/playscii](https://heptapod.host/jp-lebreton/playscii)
+
+Playscii's main website is here:
+
+* [https://jplebreton.com/playscii/](https://jplebreton.com/playscii/)
+
+## Offline documentation
+
+Playscii now includes its own HTML documentation, which you can find in the
+docs/html/ subfolder of the folder where this README resides.
+
+## Online documentation
+
+The latest version of the HTML documentation resides here:
+
+[https://jplebreton.com/playscii/howto_main.html](https://jplebreton.com/playscii/howto_main.html)
+
+## Bugs
+
+If you run into any issues with Playscii, please report a bug here:
+
+[https://heptapod.host/jp-lebreton/playscii/issues](https://heptapod.host/jp-lebreton/playscii/issues)
+
+## Roadmap
+
+For possible future features see Playscii's Trello:
+
+[https://trello.com/b/BLQBXn5H/playscii](https://trello.com/b/BLQBXn5H/playscii)
+
+Please don't take anything there as a promise, though. If you'd find something
+on there especially valuable, feel free to vote or comment!
+
+## Contact
+
+If you've made something cool with Playscii and/or have any suggestions on how
+to improve it, please let JP know!
+
+[https://jplebreton.com/#contact_email](https://jplebreton.com/#contact_email)

README.rst

@@ -1,23 +0,0 @@
-playscii
-========
-
-forked from `jp-lebreton/playscii <https://heptapod.host/jp-lebreton/playscii>`_ (v9.18).
-
-setup
------
-
-requires libSDL2 and libSDL2_mixer installed on the system::
-
-    # fedora
-    sudo dnf install SDL2 SDL2_mixer
-
-    # debian/ubuntu
-    sudo apt install libsdl2-2.0-0 libsdl2-mixer-2.0-0
-
-    # mac
-    brew install sdl2 sdl2_mixer
-
-then, with `uv <https://docs.astral.sh/uv/#installation>`_ installed::
-
-    uv sync
-    just run

pyproject.toml

@@ -16,7 +16,6 @@ dependencies = [
 dev = [
     "ruff",
     "pytest",
-    "ty",
 ]
 
 [build-system]

requirements.txt

@@ -0,0 +1,5 @@
+appdirs==1.4.0
+numpy==1.20.1
+Pillow==8.1.2
+PyOpenGL==3.1.5
+PySDL2==0.9.7