PyMagic

Getting started

To download and set up PyMagic, open a terminal or command prompt window and type the following:

$ git clone https://github.com/Python3-8/pymagic  # downloads PyMagic
$ cd pymagic  # enters the PyMagic directory
$ python3 -m pip install -r requirements.txt  # installs the dependencies that PyMagic requires

Now you are ready to run PyMagic. This can be done by executing the following from the same window, in the same directory:

$ python3 main.py

Using PyMagic

If you have run PyMagic with python3 main.py, you will now see this window:

If it is your first time using PyMagic, click the Instructions button to learn how to use PyMagic. Otherwise, click Skip. If you clicked Instructions, you will now see this:

This shows how to use PyMagic. You will be presented with a blackboard which can be turned into a whiteboard and back by pressing X. Think of this like a blackboard with you holding a piece of chalk or a whiteboard with you holding a dry-erase marker. Of course, if you move the chalk or the marker (the tool), nothing happens, because the tool is not in contact with the board. Pressing Q or the left mouse button places the tool on the board so that any movements will translate onto the board. For example, if you press Q and move the mouse pointer in a straight line on your trackpad, a line will be drawn on the board. You do not have to press and hold anything. The left Shift key changes the tool from a pen to an eraser and vice versa. The up and down arrow keys can be used to increase or decrease the tool thickness. Pressing the R key sets the pen color to red. Similarly, O is orange, Y is yellow, G is green, B is blue, V is purple, P is pink, W is white, and Z is black. After reading and learning these keys, click OK.

Whether you clicked OK after reading the instructions or skipped them, you will now be presented with a blackboard.

Use your knowledge of the keys to draw or write, and enjoy!

Note

You may realize while using PyMagic that the window snaps to specific sizes when resized. This is because the window has been programmed to always be a golden rectangle (one whose length to width ratio is 1:ϕ, or 1:(1+√5)÷2, or approximately 1:1.618) to best resemble a physical whiteboard or blackboard.