https://github.com/ragibasif/bitter

An interpreter for the Bitter esoteric programming language written in C.
https://github.com/ragibasif/bitter

bitter c-program c-programming c-programming-language c-project compiler esolang esoteric-language esoteric-programming-language interpreter virtual-machine

Last synced: 6 months ago
JSON representation

An interpreter for the Bitter esoteric programming language written in C.

• Host: GitHub
• URL: https://github.com/ragibasif/bitter
• Owner: ragibasif
• License: mit
• Created: 2025-06-02T01:22:05.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2025-06-18T02:57:55.000Z (8 months ago)
• Last Synced: 2025-06-18T03:33:47.855Z (8 months ago)
• Topics: bitter, c-program, c-programming, c-programming-language, c-project, compiler, esolang, esoteric-language, esoteric-programming-language, interpreter, virtual-machine
• Language: C
• Homepage: https://esolangs.org/wiki/Bitter
• Size: 5.44 MB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Bitter Interpreter in C

A C implementation of the Bitter esoteric programming language - a minimalist

`Brainfuck` variant that operates on single-bit memory cells. Project built for

**educational and recreational purposes.**

["Like Brainfuck - only much, much worse." - User:DMC, creator of Bitter](https://esolangs.org/wiki/Bitter)

## Hello, World

The following Bitter source code outputs "Hello, World!\n" to `stdout`:

![Hello, World!\n](./assets/hello_world.svg)

![Bitter REPL Demo 00](./assets/00_demo_hello_world_repl.gif)

## About Bitter

Bitter is a Turing-complete esoteric programming language created by [User:DMC](https://esolangs.org/wiki/User:DMC)

that operates on single-bit memory cells.

Key features:

- 1-bit memory cells

- Only 4 core commands: `<`, `>`, `(`, `)`

- 2 interpreter commands: `!`, `#`

- Infinite, unbounded memory tape (positive direction only)

- Memory initialized to 0

## Language Commands

| Command | Description                                                |

| ------- | ---------------------------------------------------------- |

| `>`     | Move pointer right by 1 and invert the bit                 |

| `<`     | Move pointer left by 1 and invert the bit                  |

| `(`     | If current bit is 1, continue; else jump past matching `)` |

| `)`     | Jump back to matching `(`                                  |

| `!`     | (Debug) Dump memory from 0 to highest data pointer reached |

| `#`     | (Debug) Pause execution and dump memory                    |

![increment and invert](./assets/inc_invert.svg)

![decrement and invert](./assets/dec_invert.svg)

## Installation

1. Clone this repository:

   ```shell

   git clone https://github.com/ragibasif/bitter.git

   cd bitter

   ```

2. Run `make`

   ```shell

   make all

   ```

## Usage

### REPL

Run the following in the command line to start the `REPL`:

```shell

./bitter

```

To exit out of the `REPL`, enter the following:

```shell

:quit

```

### Source File

Run the `./bitter` command with the `.bitr` as the argument:

```shell

./bitter .bitr

```

## Examples

```shell

examples/

├── 00_hello_world.bitr -> Load memory 0 through 111 with 'Hello, World!\n'

├── 01_truth_machine_0.bitr -> initialize data[0] = 0 and end on data[1] = 0

└── 02_truth_machine_1.bitr -> infinite loop: fill memory with 1 and dump memory

```

Example of evaluating the truth machine from the `REPL`:

![REPL Truth Machine](./assets/01_repl_demo_tm0.gif)

Example of evaluating the truth machine from a source file:

![Source File Truth Machine](./assets/02_src_file_demo_tm0.gif)

Example of evaluating the infinite loop truth machine from a source file:

![Source File Infinite Loop Truth Machine](./assets/03_src_file_demo_tm1_infinite_loop.gif)

## Acknowledgements

- [Bitter on Esolang Wiki](https://esolangs.org/wiki/Bitter)

- [User:DMC - Creator of Bitter](https://esolangs.org/wiki/User:DMC)