2019-03-08 02:28:06 +00:00
# QB64
2020-01-01 18:36:39 +00:00
< p align = "center" >
2020-07-31 00:48:27 +00:00
< img src = "https://www.qb64.org/images/githubstrip.png" / >
2020-01-01 18:36:39 +00:00
< /p
2019-03-08 02:28:06 +00:00
2020-02-22 14:29:42 +00:00
QB64 is a modern extended BASIC+OpenGL language that retains QB4.5/QBasic compatibility and compiles native binaries for Windows (XP and up), Linux and macOS.
2020-02-23 03:47:22 +00:00
[](https://github.com/QB64Team/qb64/issues)
2020-01-01 18:36:39 +00:00
2020-02-22 14:29:42 +00:00
# Table of Contents
1. [Installation ](#Installation )
2020-02-23 03:47:22 +00:00
1. [Windows ](#Windows )
2. [macOS ](#macOS )
3. [Linux ](#Linux )
2020-02-21 21:11:34 +00:00
2020-02-22 14:29:42 +00:00
2. [Usage ](#Usage )
3. [Additional Info ](#Additional_Info )
2020-02-21 21:11:34 +00:00
2020-02-23 03:47:22 +00:00
# Installation <a name="Installation"></a>
2020-02-23 03:02:49 +00:00
Download the appropriate package for your operating system over at https://github.com/QB64Team/qb64/releases.
2020-02-21 21:11:34 +00:00
2020-02-23 03:48:43 +00:00
< a name = "Windows" > < / a >
## Windows
2020-02-21 21:11:34 +00:00
2020-02-23 03:02:49 +00:00
Make sure to extract the package contents to a folder with full write permissions (failing to do so may result in IDE or compilation errors).
2020-02-21 21:11:34 +00:00
2020-02-23 03:02:49 +00:00
* It is advisable to to whitelist the QB64 folder in your antivirus/antimalware software *
2020-02-22 14:29:42 +00:00
2020-02-23 03:48:43 +00:00
< a name = "macOS" > < / a >
## macOS
2020-02-23 03:02:49 +00:00
Before using QB64 make sure to install the Xcode command line tools with:
2020-02-21 21:11:34 +00:00
```bash
xcode-select --install
```
2020-02-23 03:02:49 +00:00
The package comes with a precompiled `qb64` binary that will run as is in macOS Catalina. For older versions of macOS, run ```./setup_osx.command``` to compile QB64 for your OS version.
2020-02-22 14:29:42 +00:00
2020-02-23 03:48:43 +00:00
< a name = "Linux" > < / a >
## Linux
2020-02-23 03:02:49 +00:00
The package comes with a precompiled `qb64` binary that will run as is in most Debian-based distributions. For other distributions, compile QB64 with ```./setup_lnx.sh```.
2020-02-22 14:29:42 +00:00
2020-02-23 03:02:49 +00:00
Dependencies should be automatically installed. Required packages include OpenGL, ALSA and the GNU C++ Compiler.
2020-02-22 14:29:42 +00:00
2020-02-23 03:48:43 +00:00
< a name = "Usage" > < / a >
# Usage
2020-02-23 03:02:49 +00:00
Run the QB64 executable to launch the IDE, which you can use to edit your .BAS files. From there, hit F5 to compile and run your code.
To generate a binary without running it, hit F11.
Additionally, if you do not wish to use the integrated IDE and to only compile your program, you can use the following command-line calls:
```qb64 -c yourfile.bas```
2020-02-22 14:29:42 +00:00
2020-02-23 03:02:49 +00:00
```qb64 -c yourfile.bas -o outputname.exe```
2020-02-22 14:29:42 +00:00
2020-02-23 03:02:49 +00:00
Replacing `-c` with `-x` will compile without opening a separate compiler window.
2020-02-22 14:29:42 +00:00
2020-02-23 03:48:43 +00:00
< a name = "Additional_Info" > < / a >
# Additional Information
2020-02-23 03:02:49 +00:00
More about QB64 at our wiki: www.qb64.org/wiki
2020-02-22 14:29:42 +00:00
We have a community forum at: www.qb64.org/forum
We tweet from [@QB64Team ](https://twitter.com/QB64team )
Find us on Discord: http://discord.qb64.org
