IBB - IntyBASIC Builder

A PowerShell script to compile, assemble, and launch IntyBASIC projects automatically.

Features

• Automatic detection of required tools (intybasic, as1600, jzintv and optional bin2rom)
• Syntax check-only mode (-syntaxcheck)
• Output folder support (-outputfolder) to store final assets
• Colored and clear status messages
• Usage help and parameter aliases

Installation & Configuration

1. Download

• Download the latest version of ibb.ps1 from the GitHub repository.
• Place the script in a folder of your choice.

2. Make it Globally Available (Optional)

• To run ibb.ps1 from any location, add its folder to your PATH environment variable (either user or system vars).
• Example:
  • On Windows, open System Properties → Environment Variables → Edit PATH → Add the folder containing ibb.ps1.

3. Requirements

• IntyBASIC, AS1600, and Jzintv must be installed and available on your system.
• These tools do not have installers; simply download and extract them, then add their folders to your PATH or set the appropriate environment variables (INTV_BASIC_PATH, INTV_SDK_PATH, JZINTV_HOME).
• Optionally, you can also add Bin2rom for ROM file creation (it usually comes bundled with Jzintv and AS1600).

4. First Run

• Open a PowerShell terminal.
• Navigate to the folder containing ibb.ps1 (or any folder, if you added it to PATH).
• Run the script as shown in the usage examples:

.\ibb.ps1 <filename>

• For syntax check only:

.\ibb.ps1 <filename> -syntaxcheck

• To move final assets to a custom folder:

.\ibb.ps1 <filename> -outputfolder dist

5. Troubleshooting

• If any required tool is missing, the script will display a clear error message and a suggestion for fixing the issue.
• Make sure all tool executables are accessible from your terminal (test with intybasic, as1600, jzintv commands).

Tip: You can use parameter aliases for convenience (see the section below).

Usage

Basic Usage

You can specify the source file either as the first positional argument or with the -source flag (and its aliases):

.\ibb.ps1 demo
.\ibb.ps1 -source demo
.\ibb.ps1 demo -syntaxcheck
.\ibb.ps1 demo -outputfolder dist

• outputfolder <folder>: Moves the final .bin, .rom, and .cfg files to the specified folder (created if it doesn't exist). Jzintv will be launched from that folder.
• All intermediate files remain in the working directory.

Parameters and Aliases

• -source

  Aliases: -f, -name, -project

• -syntaxcheck

  Aliases: -sc, -checkonly, -syntax, -checksyntax

• -outputfolder

  No aliases yet

• -help

  Aliases: -?, -h

💡 Note that you can omit the file extension in <filename> and it is also case-insensitive. Any path section will be purged too.

Getting Help

• For a quick usage summary, you can run:

  .\ibb.ps1 -?
  .\ibb.ps1 -h

  Any of these - including running the script with no parameters at all - will display a concise help message and exit.

• For full documentation, use the built-in PowerShell help system:

  Get-Help .\ibb.ps1 -Full

  This will show all details, including parameters, examples, and notes.

License

This project is released under the MIT License.

Commercial use is permitted, but I kindly ask to contact the author if you plan to include this software in a commercial product or service.

Links

Website: https://inty.furinkan.org/

Repository: https://github.com/FrancescoGd/ibb/