onlymx13 / cesium Goto Github PK

Cesium is the first shell for the TI-84 Plus CE / TI-83 Premium CE calculators, and includes many useful features.

In order to transfer Cesium to your calculator, you must have a linking program, such as TI-Connect CE: https://education.ti.com/ticonnectce. Once installed:

1. Plug-in your calculator and Launch TI-Connect CE
2. Send cesium.8xp (or cesium_french.8xp if needed)
3. Drag'n'drop them onto the calculator that should be in the devices list in TI-Connect CE
4. Press the Send button in the window that pops up.

Congratulations, Cesium is now on your calculator!

For the first run, execute Cesium as you would any other assembly program by pressing 2nd + 0 and choosing the Asm( token. Then press prgm and choose CESIUM. The homescreen should look like this:

Asm(prgmCESIUM

If you have OS 5.3 or above, you can just do:

prgmCESIUM

Press enter to execute.

NOTE: The Cesium application is accessible with the apps button; not with the prgm button.

Once installed, the application cannot be transferred to other calculators. If you wish to transfer Cesium to other calculators after installation, you must transfer the installer itself to other calculators.

Cesium provides a way to quickly jump to different programs in the program browser. Simply press one of the keys with a green letter above it, and it will take you to the first program with that starts with that letter.

Shortcuts are available from the TI-OS system anywhere. Simply hold the on key and press the corresponding button to trigger the action. Available actions:

You can change the password from the settings menu (Accessed using mode), and pressing the sto→ button. This will prompt for a new password which will be automatically saved. Note: There is no default password as before.

Cesium also offers the ability to externally back up the RAM from within the OS. These are also tied to the shortcuts:

THE FLASH CHIP IS ONLY DESIGNED TO SUPPORT 100,000+ ERASE CYCLES. PLEASE BE SURE TO MODERATE USEAGE.

Cesium can run programs written in ASM, C, ICE, or BASIC, either from the archive or not. It is prefered that you place programs in the archive, as it will protect them against RAM clears. To run a program, simply press 2nd or Enter. After a program is finished running, it will return to Cesium. Note: pressing 2nd to back up RAM before running will only work if the "Backup RAM" option is enabled in the Cesium settings. Otherwise, the program will be run without backing up the RAM.

HUD:

• Displays battery level.
• Program count. (toggle in settings)
• Current time. (toggle in settings, the clock MUST be set from TI-OS for the time to be 'correct')
• Custom color scheme. (changeable in settings)

Backup features:

• Backup RAM before executing programs (with [2nd] button). If a program crashes, nothing will be deleted or lost! (toggle in settings)
• Quick launch button (the [enter] button) that skips backup process.
• External backup, if your calculator crashes outside of Cesium, everything is still protected! (done from homescreen)
• Restore External backup feature so you can revert your calculator back to its backed-up state whenever you want. (also done from homescreen)
• Video of every backup feature and how to use them: https://youtu.be/hZDzV1CDN3k

Basic Features:

• Quick launch with on + prgm (toggle in settings)

• Quick (adjustable) password lock with on + stat (toggle in settings)

• Run ASM , C, and ICE programs directly.

• Run Archived programs with any OS.

• Edit Archived BASIC programs and an instant goto for errors. (Won't edit locked programs)

• While editing program, you have access to the entire screen (the "PROGRAM:NAME" line isn't there for more space)

• Turn off run/busy indicator when running BASIC programs. (toggle in settings)

Program Features:

• Search for programs for a quick lookup. (press the letter with the green letter above it corresponding to the first letter of the program you're searching for)

• Archive programs.

• Lock programs from editing.

• Hide programs from normal prgm button (the TI-OS program menu).

• Rename a program.

• Create a program.

• Delete a program.

• Edit a program directly.

• Folder dedicated to FLASH applications.

• Folder dedicated to AppVar management.

• Automatically quits after about 20 to 25 seconds of inactivity so it won't drain your battery.

• Displays program details such as:

  • Displays an icon next to the programs name and above extra information.
  • Language the program was written in.
  • How large a program is.
  • Extra information about a program at the bottom of the HUD.

Settings

• Color selection (toggle with mode):
  • Theme color (primary color).
  • Main text color (secondary color).
  • Highlight color.
  • Inversion color.
  • Hidden programs color.
  • Background color.
• Disabling busy run indicator in Basic programs.
• Toggle show program/directory item count.
• Toggle display clock.
• Toggle running with RAM backup.
• Toggle showing special directories (Applications and AppVars).
• Enable/disable keyboard short cuts (Open Cesium hook, turn off with password hook, and external backup hooks).
• Toggle show item deletion confirmation to prevent accidentally deleting something you don't want to.
• Change LCD brightness

Language support:

• English
• French (Credits to Adriweb for translation!)

^{_{First off, why would you ever want to delete such an awesome shell?}}

To uninstall Cesium, press 2nd + + + 2 + 1 and delete the Cesium Application and appvar. Or you can delete anything Cesium from TI-Connect CE.

You can also delete the Cesium AppVar from Cesium, then delete the App itself. Exit Cesium to finish. NOTE: The "show special directories" box MUST be selected in order to see the AppVars/ Apps folder!!

Cesium uses submodules to build, so be sure to clone the project like so: Go to a new folder, then run the following command(s):

git clone --recursive https://github.com/mateoconlechuga/cesium.git

Download fasmg and place it in the root directory of the repository (Available for your OS near the bottom of this page), or add it to your global PATH variable.

Build Cesium using the following make commands, depending on what language you want:

make
make english
make french

(C) October 2015 - July 2018 Matt "MateoConLechuga" Waltz Licensed under BSD 3 Clause.

Source is available here: https://github.com/mateoconlechuga/cesium

Make a GitHub issue here: https://github.com/mateoconlechuga/cesium/issues

If you encounter an unexpected behavior, please make an issue on GitHub and/or post a topic on TI community websites detailing exactly went wrong and when. (If there isn't a GitHub issue for a bug, it will likely be ignored) Thanks!