Giter Club home page Giter Club logo

basically-ti-basic's Introduction

Basically, TI-Basic

PyPI version Downloads PyPI license Maintenance GitHub issues

Software to make working with TI-Basic files much easier on the PC by decompiling and recompiling the .8Xp files from the TI-83/TI-84 calculators. For more information about the 8Xp file format, see the site listed in the credits and the 8XP_Format.md file, which contains additional reverse-engineered information.

If you're looking for files to compile/decompile, you can find a number of TI programs at https://github.com/thenaterhood/ti-programs.

Installation

basically_ti_basic can be installed via pip with pip3 install basically-ti-basic, or it can be built. Once Python (3+) is installed on the target system, simply clone the repository and navigate to the cloned repository in the command line. Once there, run python setup.py install. You should be good to go.

Usage

basically_ti_basic provides a command line utility and a few libraries.

The command line utility should be available in your shell as the command basically-ti-basic. The utility allows for compilation and decompilation of TI-83+ .8Xp files. It provides the option to write the result to a file or print it to the console. Some usage examples:

Open the file FIBO.8Xp, decompile it, and save the result to FIBO.txt

$ basically-ti-basic -d -i FIBO.8Xp -o FIBO.txt

Open the file FIBO.txt, compile it, and save the result to FIBO.8Xp

$ basically-ti-basic -c -i FIBO.txt -o FIBO.8Xp

Open the file FIBO.8Xp, decompile it, and print the result to the console

$ basically-ti-basic -d -i FIBO.8Xp

basically_ti_basic can be used in a program as well.

import basically_ti_basic as btb

# Decompile 8Xp file
btb.decompile_file("input.8Xp", "tibasic.txt")

# Compile 8Xp file from TI-BASIC code
btb.compile_file("tibasic.txt", "output.8Xp")

Heads Up! The TI file creation (compilation) functionality is incomplete and may produce malformed files. Use it with caution and make sure to back up your calculator before loading any compiled files onto it.

LICENSE

basically_ti_basic is licensed under the MIT license. The full license text can be found in the LICENSE file.

If you find basically_ti_basic useful, use it regularly, or build something cool around it, please consider contributing, providing feedback or simply dropping a line to say that basically_ti_basic is useful to you. Feedback from users is what keeps open source projects strong.

Credits

Special thanks to http://merthsoft.com/ for their TI-83+/TI-84+ Link Protocol Guide, which was a big help in writing sections of this software, and thenaterhood for originally writing it.

basically-ti-basic's People

Contributors

tabulatejarl8 avatar thenaterhood avatar

Stargazers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.