Troubleshooting
While KodeByter is generally user-friendly and easy to install, it isn't without its issues. This wiki article will help you troubleshoot your issues with KodeByter.
Jump to:
Before reading more read this wiki page for more information on properly installing KodeByter.
KodeByter only has one dependency, python, so there isn't much to worry about there. It is not unheard of for Linux to have installation failures when installing software so there could still be issues. Oftentimes you'll just need to install it a second time though. If installing from Reborn OS through pacman, it may ask you to delete some files. Just say yes. If it spits out errors, just try again. If it still doesn't work after two or three tries, try to force it by running these commands as root:
pacman -Syy
pacman -S KodeByter --force
You should now be able to install the software.
If you are on anything other than Reborn OS, then try this wiki section on installing on any Linux Platform. After following these steps you should get it working flawlessly.
Note: If your KodeByter install isn't updating on its own, try running pacman -Syy then pacman -S KodeByter --force as root.
Even after installing everything correctly there can still be problems. If you are having issues with running the program, try seeing if it crashes immediately. If it does that means that there is a Python issue with syntax. This can be from outdated code or an outdated Python version. To check the issue, open up a terminal and type:
kodebyter
You will be able to see the errors without the window closing. Post the issues in the Issues and we'll see if we can help you. Otherwise, try the solution below.
If you are running a non-rolling release of Linux your Python version will be out of date. Even Ubuntu Bionic isn't up to date. Since this application is made for Reborn OS (Arch Linux-based) it will be on the bleeding edge meaning that Ubuntu and Debian will be left in the dust. You can still get an outdated version of the program that works the exact same but works with older Python versions. It is available from here. So follow the steps from the installation wiki section about installing on all platforms but replace the kodebyter.py file with the older version.
Certain things may cause KodeByter to crash. If KodeByter is unexpectedly crashing for no apparent reason, the leading causes are unexpected characters and "rotation" integers that are too long. Invalid characters include letters and symbols inside the "Enter rotation:" dialog. The numbers entered there can only be whole numbers that are not greater than your CPU can handle. See the Limitations section of the "How to use the software" wiki article for more details.
