I ran into a bug or problem, how should I report it?

Check out the Issues on GitHub and see if there's already an open issue. Also, read the rest of this FAQ to see if it addresses your problem.

If not, create an issue for the problem through the link above. Thanks!

I get ERR:INVALID when I try to run the emulator! What’s wrong?

TI-OS versions 5.5 and newer removed the ability to run ASM programs. You have to use a jailbreak such as arTIfiCE to restore this functionality.

Also, on TI-OS versions prior to 5.3 you must unarchive the TIBOYCE program in the Memory menu and use the Asm( command from the Catalog to run it.

Can this play Game Boy Color games?

Yes! However, GBC is a stronger system so the performance may be worse, depending on the game.

Note that some games cannot be played at all due to storage limitations; the calculator has only 3MB of storage, and a number of GBC games are 4MB. Some of these games may still fit if there is enough empty space in the ROM that can be trimmed by the converter (see the later FAQ about storage). The approximate limit is when the ROM converter produces files numbered up to 40.

There are also some remaining issues to be resolved with certain games, mostly when they attempt to display more than 56 colors at once. These games will run, but the colors may appear strange or the graphics garbled. This should be addressed in a future release.

What about Game Boy Advance?

No. Just no.

My original Game Boy game isn’t colorized, why not?

Only games in the Game Boy Color's colorization database will receive an automatic color palette. For the others, you can select a palette manually in the settings.

How does saving work?

If a game has in-game saves stored on the cartridge, these are always saved when exiting the game (to a file ending in SAV). These will be preserved when restarting the game, and in the unfortunate case of a soft crash the emulator will attempt to save this data.

By default, the emulator will also automatically save the current game state when exiting (to a file ending in StA) and automatically load it when starting again, much like Nintendo's Virtual Console. Note that the StA file will not load without the corresponding SAV file.

In addition, you can save or load the current game state to one of 10 slots through the emulator menu (to a file ending with St#, and potentially one with Sv# if there are in-game saves, where # is the slot number). These will stick around more reliably than auto save states, but keep in mind that a pair of St# and Sv# files can't be mixed and matched.

Currently most of these files must be managed through the calculator's Memory menu, though it's now possible to delete save states and ROM files directly from the emulator. However, all of this information will still be useful when you need to transfer files to a PC or another calculator.

I tried sending converted ROM files to my calculator, but it tells me I’m out of space even though I clearly have enough! What’s going on here?

This is a quirk of TI's Archive storage system. Archive memory is split into 64KB sectors, and any given variable must be contained completely within that sector.

Meanwhile, converted ROM files are split into 16KB contiguous chunks for performance reasons (several of these chunks may be contained in a single AppVar).

If there is no empty space at the end of these ROM chunks that can be trimmed out, only three of them can fit into an AppVar, taking slightly over 48KB of space. Whichever Archive sector holds this variable can only store files less than 16KB large in the remaining space, which means no more ROM data.

In this worst case scenario (when no trimming is possible), this would mean you can only use 3/4 of your Archive space to store ROMs.

tl;dr: It's expected behavior but there's no good solution for it other than deleting large files to make room. Sorry!

I want to link to my buddy’s calculator so we can trade pokeymans! Pretty please?

I'd like to make linking work, it would be pretty cool! I even bought a second calculator so I can mess around with that idea.

USB is difficult though, and so is synchronizing emulation between two devices. I can't make any promises, but I'll at least give it a try sometime!