In this page, there will be common troubleshooting steps to help resolve issues with running Etterna.
If this error appears after attempting to open the game, DirectX9 needs to be installed on your computer. Choose a link to fix this problem.
If Etterna appears to constantly re-open and close:
Make sure that you have followed the above installation steps correctly. In particular, make sure that you are not opening the Etterna.app from inside of the disk image! This will cause our App Un-Translocation code to fail and cause the above symptom.
If Etterna doesn't open at all, with a message about the app being untrusted, not signed, or the like:
Remove the com.apple.quarantine extended attribute from the game files by running the following command in Terminal, replacing the path as appropriate for your system:
xattr -rd com.apple.quarantine /path/to/Etterna.app
If you followed the above instructions exactly and Etterna is installed under your Applications folder, the following command will b e correct:
xattr -rd com.apple.quarantine /Applications/Etterna/Etterna.app
Try following the steps outlined in BlueBandit201's macOS Input Troubleshooting Guide.
If your computer is running OSX High Sierra, you may be running into a known bug:
Try disabling your computers internet connection while starting the game and it should hopefully load without crashing.
After making it into the song selection screen without crashing, you should be able to re-enable it without causing the game to crash.
Unfortunately, if the above applies to you, this workaround means you will have to manually install packs instead of using the in-client pack downloader, and certain features of Etterna such as online leaderboards and multiplayer will not work.
See: https://github.com/etternagame/etterna/issues/1186 for further information and technical details.
If your computer is not running OSX High Sierra:
Double-check that you've followed all of the above installation steps. If you have, please contact us!
You may have discovered a new bug we aren't familiar with yet.
No troubleshooting methods covered here yet. Contribute?