# freegemas

**Repository Path**: mirrors_deckarep/freegemas

## Basic Information

- **Project Name**: freegemas
- **Description**: Freegemas is an open source version of the well known Bejeweled, built in Zig using SDL2 ported from the original C++ version
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-18
- **Last Updated**: 2026-01-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
    <img src="https://github.com/deckarep/freegemas/blob/zig-version/static/images/header_logo.png"><br>
    <img src="https://github.com/deckarep/freegemas/blob/zig-version/static/images/header_gems.png"><br>
</p>

__Freegemas__ is a GPL2.0 open source version of the well known Bejeweled, for MacOS and GNU/Linux, ~and Windows~. It's written in [Zig 0.13.0](https://ziglang.org) using [SDL2](https://www.libsdl.org/). This version is a Zig-based port of the [original C++ version by Jose Tomas Tocino](https://github.com/JoseTomasTocino/freegemas). Since the original license is an
open source copyleft license this repo is required to use the same exact license.

<p align="center">
    <img src="https://github.com/deckarep/freegemas/blob/zig-version/static/images/screenshot_1.png">
</p>

## Supported Systems
- [x] MacOS
- [x] Linux
- [ ] Windows (contributions welcome to get this building there)
        
## Installation on OS X

First, head over to [ziglang.org](https://ziglang.org) and download *Zig 0.13.0* or newer.

This assumes that you are already using [Homebrew](https://brew.sh/). You will need a few libraries to compile Freegemas:

    brew install sdl2 sdl2_mixer sdl2_ttf sdl2_image

Now run the following commands to setup your environment to use Homebrew as a backup location for libraries.

After that, clone the repo:

    git clone https://github.com/deckarep/freegemas.git
    
To compile from source:

    cd freegemas
    zig build run
    ./freegemas

## Installation on Debian-based GNU/Linux systems

First, head over to [ziglang.org](https://ziglang.org) and download *Zig 0.13.0* or newer.

Next, install SDL2. You will need a few libraries to compile Freegemas:

    sudo apt-get install libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev libsdl2-mixer-dev

Now run the following commands to setup your environment to use Homebrew as a backup location for libraries.

After that, clone the repo:

    git clone https://github.com/deckarep/freegemas.git

To compile from source:

    cd freegemas
    zig build run
    ./freegemas

## Music licensing

The music in the game is [Easy Lemon by Kevin MacLeod](https://incompetech.com/music/royalty-free/index.html?isrc=USUAN1200076)
Licensed under [Creative Commons: By Attribution 3.0](https://creativecommons.org/licenses/by/3.0/)