All I see is a black screen!

You probably have a laptop with a crappy video controller. There is still hope for you. AT2 uses OpenGL by default to accelerate the display. You can disable it either via the File > Setup > General menu, but as you can not see it, you can use the command line:

ArkosTracker2 – useOpenGL 0

(yes, there are two “-“. Use 1 instead of 0 to put OpenGL back).

This will probably make the pattern viewer slow, but then, blame your hardware.


There are strange freezes!

See the answer above. You might want to disable OpenGL.


On Linux, loading/saving a file shows a custom file chooser. Can’t I use the one from my OS, which I like?

Yes, it should be default, but some Linux desktops don’t have one (XFCE for example). Please install kdialog or zenith, and their file picker will be automatically used.


I have a high latency on Windows, there is one second between pressing a key and hearing the sound!

This is related to your sound card and/or its drivers. Three possibilities:

  • In AT2, go to File>Setup>Audio, and decrease the “audio buffer size” as much as possible.
  • If it doesn’t work, try changing the audio device type at the top of the same window.
  • Still not better? You will have to install a low-latency driver. A good sound card should allow ASIO (you should have seen it in the audio device type), but if not, install the ASIO4All drivers. Don’t worry, it’s harmless. Once it is done, don’t forget to select this driver still in the audio device type list.

Exporting in binary fails!

Please make sure your export address is not too high! Your music may be too big, so the embedded assembler (Rasm) failed to compile it, because you’ve gone past &FFFF. Z80 binary export can only target a 16 bits memory range!


The command line tools only export one subsong!

This is the default behavior. Use the “-sp” or “–subsongsAndPsgs” option to set the subsongs to extract.

The music doesn’t sound the same on the hardware!

Make sure you have selected the correct PSG frequency in the Song Properties, as well as the right PSG (AY/YM)!

The player crashed/doesn’t work properly

Before sending me the music for me to test (mandatory!), please check that:

  • The stack is in a safe location.
  • You used the right player configuration files. If you don’t, the player will crash indeed. If using the player configuration feature, the player is tailored to a specific song(s), so using the same player with another song will surely crash!
  • You used the right player with the right song. Using the AKG player with a non-AKG generated song will crash, obviously.
  • Make a test without the player configuration files.
  • Make a test with the RAM player, not the ROM player, if possible.
  • If you were using Disark, try to make a test without, and only use Rasm and a non-relocatable binary of the player.
  • Remove the use of sound effects, if you were using some.
  • According to your system, do the interruptions need to be disabled when calling the player (shouldn’t be necessary, but do it just to test)?
  • Does the system of your OS require some registers to be saved? If yes, then do so (for example, on CPC, the system (SYSTEM, I said) interruption handler requires BC’ and AF’ to be saved).
  • Please bear in mind that the players, most of the time, modify ALL the registers, including IX, IY, and the auxiliary ones! Save them if needed!  Save them all if using the player in an interruption handler!

The app crashed!

This is unlikely. Really. However, logs may have been saved. Please copy and paste them to me. They should be found, depending on your platform, on these locations:

  • On Windows: c:\Users\<username>\AppData\Roaming\ArkosTracker2\crashlog.txt
  • On Linux: home/<username>/.config/ArkosTracker2/crashlog.txt
  • On Mac: ~/Library/Logs/ArkosTracker2/crashlog.txt


On this website, my mouse wheel accelerates too much!

This one comes from Grim, which also provided the answer (thanks!): use your favorite adblocker to block this and this JS script.

Lee Bee provided more explanations: Adblock Plus settings > Advanced > My filter list > Edit filters > paste the two urls into the box.