Gearcoleco - Le Bottin des Jeux Linux

Gearcoleco

🗃️ Specifications

📰 Title: Gearcoleco 🕹️ / 🛠️ Type: Tool
🗃️ Genre: Emulation 👁️ Visual: 2D
🏷️ Category: Emulation ➤ Engine ➤ Coleco 🏝️ Perspective: Third & First person
🔖 Tags: Emulation; COLECO; colecovision; libretro compatible; BIOS ROM required; Multi-platform; Controller ⏱️ Pacing: Real Time
🐣️ Approx. start: 2021-08-01 👫️ Played: Single
🐓️ Latest: 2025-04-17 🚦 Status: 05. Tested & Working (status)
📍️ Version: Latest: 1.5.0 / Dev: 6576bdd ❤️ Like it: 2. 👏️⭐⭐⭐⭐ (excellent)
🏛️ License type: 🕊️ Libre 🎀️ Quality: 1. 🏆️⭐⭐⭐⭐⭐ (perfect)
🏛️ License: GPL-3 ✨️ (temporary):
🐛️ Created: 2025-04-21 🐜️ Updated: 2025-05-04

📦️ Deliverables

📦️ Package name: gearcoleco ..... 📦️ Arch: ✓
📄️ Source: ✓ ..... 📦️ RPM:
⚙️ Generic binary: ✓ ..... 📦️ Deb:
🌍️ Browser version: ..... 📦️ AppImage:
📱️ PDA support: ..... 📦️ Flatpak:
✨️ Not use: ..... 📦️ Snap: ✓

🚦 Entry status

📰 What's new?: 💥️ New 👻️ Temporary:
💡 Lights on: 📰 Previous News:
🎨️ Significant improvement: 💭️ New version published (to be updated):
🎖️ This work: 5 stars 🦺️ Work in progress:
👫️ Contrib.: goupildb 🚧️ Some work remains to be done:
🎰️ ID: 16502

📖️ Summary

📜️[en]: A libre, multi-platform Colecovision emulator with the emphasis on emulation precision. It requires the use of an external BIOS (no HLE BIOS available). Features include support for console peripherals (ColecoVision Super Game Module (SGM), MegaCart ROMs, Super Action Controller (SAC), Wheel Controller and Roller Controller), drag & drop content, compressed content, save state, 2 controllers, automatic game/sound interrupt on loss of focus. It also offers a comprehensive debugger. An excellent emulator. 📜️[fr]: Un émulateur libre et multi-plateforme Colecovision mettant l'accent sur la précision de l'émulation. Il requiert l'utilisation d'un BIOS externe (pas de BIOS HLE disponible). Il offre notamment le support de périphériques de la console (ColecoVision Super Game Module (SGM), MegaCart ROMs, Super Action Controller (SAC), Wheel Controller et Roller Controller), du glisser-déposer de contenu, du contenu compressé, de la sauvegarde d'état, et de 2 contrôleurs, de l'interruption automatique du jeu/son sur perte du focus. Il offre également un débogueur complet. Un excellent émulateur.

🎥️ Videos


🦝️ From Users: (1.0/202111),


📰 Progress: Mr. Sujano (202504),


🎮️ Showcase: (1.1.0/202403), (202203), (202307),

🕸️ Links

🏡️ Website & videos
Website: [Homepage] [Dev site] [Features/About] [Screenshots]
Videos: t(202xxx) gd(202xxx) gu(1.0/202111) r(202xxx) lp(202xxx) d(1.1.0/202403) d(202203) d(202307) d(o)(202208) d(o)(202205) d(o)(202208) ht(202306) ht[fr](202xxx) ht[de](202xxx) ht[ru](202xxx) ht[pl](202xxx) ht[cz](202xxx) ht[sp](202404) ht[pt](202xxx) ht[it](202xxx) ht[tr](202xxx)]
Doc: [WIKI] [FAQ]
Updates: [RSS] [Changelog 1 2 3]

💰 Commercial
[Support their work (Donate)]

🍩️ Resources

🔘️ Libretro compatibility
• Port of this emulator to libretro : [Libretro (emulator name) (Libretro WIKI)]

🔘️ Games
• 🗿️See also our entry: Resources - Emulation - Coleco ColecoVision

🛠️ Technical informations
[PCGamingWiki] [MobyGames]

🦣️ Social
Devs (Gearcoleco Team 1 2 [fr] [en]): [Site 1 2] [Chat] [mastodon] [PeerTube] [YouTube] [PressKit] [Interview 1(202xxx) 2(202xxx)]
Devs (Ignacio Sanchez Gines (drhelius) 1 2 [fr] [en]): [Site 1 2] [Chat] [mastodon] [PeerTube] [YouTube] [PressKit] [Interview 1(202xxx) 2(202xxx)]
The Project: [Blog] [Chat] [Forums] [mastodon] [PeerTube] [YouTube] [PressKit] [Lemmy] [reddit] [Discord]

🐝️ Related
[Wikipedia (ColecoVision) [fr] [en] [de]]

📦️ Misc. repositories
[Repology] [pkgs.org] [Generic binary] [Arch Linux / AUR] [openSUSE] [Debian/Ubuntu] [Flatpak] [AppImage(author's repo)] [Snap] [PortableLinuxGames]

🕵️ Reviews
[HowLongToBeat] [metacritic] [OpenCritic] [iGDB]

🕊️ Source of this Entry: [Mr. Sujano (20250415)]

🦣️ Social Networking Update (on mastodon)

🛠️ Title: Gearcoleco
🦊️ What's: A libre & very accurate Colecovision emulator
🏡️ -
🐣️ https://github.com/drhelius/Gearcoleco
🔖 #LinuxEmulation #Coleco #Colecovision #HLEBIOS
📦️ #Libre #Bin #Arch #Snap
📖 Our entry: https://lebottinlinux.vps.a-lec.org/LO.html
🕵‍ 1.5.0: 👏️⭐⭐⭐⭐

🥁️ Update: 1.5.0
⚗️ Signific. vers. 🦍️
📌️ Changes: https://github.com/drhelius/Gearcoleco/releases
🦣️ From: 📰 https://www.youtube.com/embed/NP0P3aYMImI?start=42
🛜️ https://github.com/drhelius/Gearcoleco/releases.atom

🦝️1.0 https://www.youtube.com/embed/g3JQP6Ivx9k
🎮️ https://www.youtube.com/embed/j9zuEDxmQ2s
🎮️ https://www.youtube.com/embed/Arz6Kmn1uyg
🎮️ https://www.youtube.com/embed/6FBPuOtviX8

🕶️ A view of its UI (on a dark theme, under Linux) with the game Congo Bongo, a 2.5D platform game with gameplay similar to Donkey Kong where the objective is to catch the monkey Bongo at the top of the mountain.

📚️ Gearcoleco is a libre, multi-platform Colecovision emulator with the emphasis on emulation precision. It requires the use of an external BIOS (no HLE BIOS available). Features include support for console peripherals (ColecoVision Super Game Module (SGM), MegaCart ROMs, Super Action Controller (SAC), Wheel Controller and Roller Controller), drag & drop content, compressed content, save state, 2 controllers, automatic game/sound interrupt on loss of focus. It also offers a comprehensive debugger. An excellent emulator.

📕 Description [en]

📜️ "A libre & very accurate Colecovision emulator" 📜️

Gearcoleco is a very accurate cross-platform ColecoVision emulator written in C++ that runs on Windows, macOS, Linux, BSD and RetroArch.

This is an open source project with its ongoing development made possible thanks to the support by these awesome backers. If you find it useful, please consider sponsoring.

Don't hesitate to report bugs or ask for new features by opening an issue.

Features

✅️ Accurate Z80 core, including undocumented opcodes and behavior like R and MEMPTR registers.
✅️ Accurate TMS9918 emulation.
✅️ Support for ColecoVision Super Game Module (SGM) and MegaCart ROMs.
✅️ Support for Super Action Controller (SAC), Wheel Controller and Roller Controller.
✅️ Save states.
✅️ Compressed rom support (ZIP).
✅️ Supported platforms (standalone): Windows, Linux, BSD and macOS.
✅️ Supported platforms (libretro): Windows, Linux, macOS, Raspberry Pi, Android, iOS, tvOS, PlayStation Vita, PlayStation 3, Nintendo 3DS, Nintendo GameCube, Nintendo Wii, Nintendo WiiU, Nintendo Switch, Emscripten, Classic Mini systems (NES, SNES, C64, ...), OpenDingux, RetroFW and QNX.
✅️ Full debugger with just-in-time disassembler, CPU breakpoints, memory access breakpoints, code navigation (goto address, JP JR and CALL double clicking), debug symbols, memory editor, IO inspector and VRAM viewer including registries, tiles, sprites and backgrounds.
✅️ Windows and Linux Portable Mode.
✅️ ROM loading from the command line by adding the ROM path as an argument.
✅️ Support for modern game controllers through gamecontrollerdb.txt file located in the same directory as the application binary.

Tips

Basic Usage

• BIOS: Gearcoleco needs a BIOS to run. It is possible to load any BIOS but the original one with md5 2c66f5911e5b42b8ebe113403548eee7 is recommended.
• Spinners: When using any kind of spinner it is useful to capture the mouse by pressing F12. It is also recommended to disable spinners for software that don't use them.
• Overscan: For a precise representation of the original image, using Overscan Top+Bottom and 4:3 Display Aspect Ratio is recommended.
• Mouse Cursor: Automatically hides when hovering over the main output window or when Main Menu is disabled.
• Portable Mode: Create an empty file named portable.ini in the same directory as the application binary to enable portable mode.

Debugging Features

• Docking Windows: In debug mode, you can dock windows together by pressing SHIFT and dragging a window onto another.
• Multi-viewport: In Windows or macOS, you can enable "multi-viewport" in the debug menu. You must restart the emulator for the change to take effect. Once enabled, you can drag debugger windows outside the main window.
• Debug Symbols: The emulator automatically tries to load a symbol file when loading a ROM. For example, for path_to_rom_file.rom it tries to load path_to_rom_file.sym. You can also load a symbol file using the GUI or the CLI.

Command Line Usage

gearcoleco [rom_file] [symbol_file]

📕 Description [fr]

Un émulateur libre et précis de console Colecovision, par la Gearcoleco Team, initié par Ignacio Sanchez Gines (drhelius).
En C++/C.

Gearcoleco est un émulateur libre et multi-plateforme Colecovision mettant l'accent sur la précision de l'émulation. Il requiert l'utilisation d'un BIOS externe (pas de BIOS HLE disponible). Il offre notamment le support de périphériques de la console (ColecoVision Super Game Module (SGM), MegaCart ROMs, Super Action Controller (SAC), Wheel Controller et Roller Controller), du glisser-déposer de contenu, du contenu compressé, de la sauvegarde d'état, et de 2 contrôleurs, de l'interruption automatique du jeu/son sur perte du focus. Il offre également un débogueur complet. Un excellent émulateur.


Gearcoleco est un émulateur ColecoVision multiplateforme très précis écrit en C++ qui fonctionne sous Windows, macOS, Linux, BSD et RetroArch.

Il s'agit d'un projet open source dont le développement continu est rendu possible grâce au soutien de ces formidables backers. Si vous le trouvez utile, envisagez de le sponsoriser.

N'hésitez pas à rapporter des bugs ou à demander de nouvelles fonctionnalités en ouvrant un problème.

Caractéristiques

✅️ Noyau Z80 précis, incluant les opcodes et comportements non documentés comme les registres R et MEMPTR.
✅️ Emulation précise du TMS9918.
✅️ Support pour ColecoVision Super Game Module (SGM) et MegaCart ROMs.
✅️ Support pour Super Action Controller (SAC), Wheel Controller et Roller Controller.
✅️ Sauvegarde d'états.
✅️ Prise en charge des ROM compressées (ZIP).
✅️ Plates-formes supportées (autonome) : Windows, Linux, BSD et macOS.
✅️ Plates-formes supportées (libretro) : Windows, Linux, macOS, Raspberry Pi, Android, iOS, tvOS, PlayStation Vita, PlayStation 3, Nintendo 3DS, Nintendo GameCube, Nintendo Wii, Nintendo WiiU, Nintendo Switch, Emscripten, Classic Mini systems (NES, SNES, C64, ...), OpenDingux, RetroFW et QNX.
✅️ Débogueur complet avec désassembleur juste à temps, points d'arrêt CPU, points d'arrêt d'accès à la mémoire, navigation dans le code (adresse goto, JP JR et double clic CALL), symboles de débogage, éditeur de mémoire, inspecteur IO et visualiseur VRAM avec registres, tuiles, sprites et arrière-plans.
✅️ Mode portable pour Windows et Linux.
✅️ Chargement de ROM à partir de la ligne de commande en ajoutant le chemin de la ROM comme argument.
✅️ Prise en charge des contrôleurs de jeu modernes grâce au fichier gamecontrollerdb.txt situé dans le même répertoire que le binaire de l'application.

Conseils

Utilisation de base

- BIOS : Gearcoleco a besoin d'un BIOS pour fonctionner. Il est possible de charger n'importe quel BIOS mais le BIOS original avec le md5 2c66f5911e5b42b8ebe113403548eee7 est recommandé.
- Spinners : Lors de l'utilisation de tout type de spinner, il est utile de capturer la souris en appuyant sur F12. Il est également recommandé de désactiver les spinners pour les logiciels qui ne les utilisent pas.
- Surbalayage : Pour une représentation précise de l'image originale, il est recommandé d'utiliser l'option Overscan Top+Bottom et le rapport d'aspect d'affichage 4:3.
- Curseur de la souris : Se cache automatiquement lorsqu'il se trouve au-dessus de la fenêtre de sortie principale ou lorsque le menu principal est désactivé.
- Mode portable : Créez un fichier vide nommé portable.ini dans le même répertoire que l'application binaire pour activer le mode portable.

Fonctionnalités de débogage

- Fenêtres d'ancrage : En mode débogage, vous pouvez ancrer des fenêtres ensemble en appuyant sur SHIFT et en faisant glisser une fenêtre sur une autre.
- Multi-viewport : Sous Windows ou macOS, vous pouvez activer le « multi-viewport » dans le menu de débogage. Vous devez redémarrer l'émulateur pour que la modification soit prise en compte. Une fois activée, vous pouvez faire glisser les fenêtres du débogueur en dehors de la fenêtre principale.
- Symboles de débogage : L'émulateur essaie automatiquement de charger un fichier de symboles lors du chargement d'une ROM. Par exemple, pour path_to_rom_file.rom, il essaie de charger path_to_rom_file.sym. Vous pouvez également charger un fichier de symboles à l'aide de l'interface graphique ou de la ligne de commande.

Utilisation de la ligne de commande

gearcoleco [rom_file] [symbol_file]

🚧️ Installation ➜ 🚀️ Launching [fr]

⚙️ Installation à partir du binaire

📦️ Installation à partir du/des paquet(s) Manjaro/Arch :
• Il(s) est/sont dans les dépôts Manjaro/Arch, il suffit d'installer le(s) paquet(s).

⛓️ Installation à partir du binaire classique :
• Un binaire statique est disponible, décompressez le livrable, et rendez son binaire exécutable (clic droit sous votre gestionnaire de fichier).

📦️ Installation (méthode alternative) à partir du binaire au format Snap :
• Un binaire au format Snap est disponible.

▸ Installation de snap :
(L'installation du gestionnaire de paquets Snap (et ses commandes de base) est aussi décrite sur la fiche "0 03 - Glossaire & licences courantes").
Si ce n'est déjà fait, installez le paquet : snapd

▸ Installation du jeu au format Snap :
Après avoir installé snapd (en dépôt), lancez en console ("your_snap_package" étant le nom de votre jeu) : # snap install your_snap_package

💡Nota :
[The Linux Experiment] compare les différents formats (Snaps vs Flatpaks vs Appimages) en novembre 2023.



📄️ Installation à partir du source

• Source non testé.


🏕️ Installation du contenu / des données :

• Données : Ce jeu/moteur requiert l'installation de données non livrées avec le moteur du fait d'une licence incompatible ou tout simplement pour lui permettre d'utiliser différents sets de données.
• BIOS : Cet émulateur requiert l'installation du/des BIOS de la console (voir la section “Resources” ci-avant) non livré avec l'émulateur du fait d'une licence incompatible. Le seul moyen est de le récupérer à partir de votre console de jeu ou de le télécharger sur internet - si le vendeur de la console le fournit. Tout autre moyen est illégal.


🚀️ LANCEMENT DE L'ÉMULATEUR

▸ Classique :
• Si vous l'avez installé à partir d'un paquet / dans l'un des répertoires système : [Alt+F2] gearcoleco ou $ gearcoleco
• Ou, rendez son binaire exécutable (clic droit sous votre gestionnaire de fichier) et cliquez dessus, ou dans son répertoire racine lancez : $ ./gearcoleco
💡 Nota : si vous l'avez installé via votre gestionnaire de paquets et ne connaissez pas le nom précis du binaire, sélectionnez le paquet dans votre gestionnaire, et dans l'onglet “Fichiers” recherchez son nom dans l'arborescence d'installation (le binaire est généralement installé dans /usr/bin/).

▸ Snap :
• Si vous l'avez installé à partir d'un paquet snap, lancez : $ /snap/bin/(nom de l'appli) (ou $ snap run (nom de l'appli))


⌨️🖱️🎮️ CONTRÔLES :

• Crédit (ajouter une pièce, dans certains jeux comme Space Invaders) : dans Input ➜ Keyboard ➜ Player 1 ➜ associer une touche à "Keypad #"
• Nombre de joueurs (Sélectionner 1 ou 2 joueurs, dans certains jeux comme Space Invaders) : dans Input ➜ Gamepads ➜ Player 1 ➜ Button Configuration ➜ associer une touche à "Keypad 1" (pour 1 joueur) et "Keypad 2" (pour 2 joueurs)

🕵️ Test [fr]

📜️ Préambule :
⚬ 1ere édition : le 21 Avril 2025 sous Manjaro. Par : goupildb. ⏱️ Durée du test : 30 minutes. 🎯️ Objectif : Initialisation de l'entrée, tests et premières impressions.


🫕️ Installation :
▸ (🧪️not_tested) Paquet Arch/AUR : NON TESTE.
▸ (🧪️not_tested) Paquet Snap : NON TESTE.
▸ (✔ v. 1.5.0) Binaire classique : FONCTIONNEL.
🟢️ Il est très facile à installer et à lancer grâce à ses différents types de livrables disponibles.
🟠️ Une installation rendue plus difficile par la nécessité d'installer un BIOS externe non libre.


🏗️ Réalisation :

‣ 📟️ Interface
🟢️ Une interface magnifique (thème sombre), de qualité, très soignée, simple, mature, efficace, dynamique (réaction de l'interface au survol de la souris), claire/intuitive, agréable à utiliser,
🟢️ Elle offre notamment une pléthore de paramétrages, le plein écran et le fenêtré, un redimensionnement de sa fenêtre par glisser-déposer, plusieurs types de mise à l'échelle graphiques (conserver le rapport hauteur/largeur ou étirer), une gestion de la synchronisation verticale (on/off), des scanlines, de l'overscan (surbalayage), la pause automatique sur perte de focus, la pause à la demande (par combinaison de touches), la sauvegarde d'état, des emplacements de sauvegarde (d'état), une vitesse d'émulation modulable, un débogueur complet,
🟠️ Point(s) faible(s) relevé(s) : il lui manque un BIOS alternatif libre,

‣ 🎮️ Contrôles
🔍️ (Logitech Rumblepad) : ✔ Functional
🔍️ (Microsoft Xbox Elite Wireless Controller Series 2) : 🪪️ Not recognized

⚪️ Il/Elle se contrôle au clavier ou au gamepad.
🟢️ Il/Elle bénéficie de contrôles redéfinissables, précis, du support des touches fléchées (important pour les claviers non anglophones), d'un excellent support du gamepad (à bon escient, bonifiant son gameplay), et il se joue aussi très bien avec les touches fléchées.
🟢️ Cet émulateur est clairement adapté pour être joué au gamepad.
🟠️ Il faut être vigilant à ce que l'interface ne perde pas le focus, sinon on a l'impression que le gamepad ne fonctionne pas. D'autant qu'à chaque fois que l'on fait un glisser-déposer d'une ROM on pense avoir le focus sur l'émulateur car le jeu démarre avec le son, mais ce n'est pas le cas.

‣ 🎧️ Son
🟢️ L'émulateur bénéficie d'un bon support du son.
🟢️ Il/Elle offre notamment l'interruption sonore automatique sur perte de focus, la désactivation sonore,

‣ 🏞️ Graphismes
🟠️ Point(s) faible(s) relevé(s) : il lui manque davantage de filtres graphiques (LCD, SuperEagle, 2xSaI, Super2xSaI, hq2x, ...) pour améliorer son graphisme,

‣ 🍯️Contenu
🟢️ Il/Elle offre le support du glisser-déposer de contenu, la lecture du contenu compressé (testé),
🟢️ 1982 - Coleco Colecovision : c'est une console de 2eme génération (CPU Z80 8 bits, 1ko de RAM, 16 couleurs avec une définition jusqu'à 256x192) sortie en 1982. Elle utilise des cartouches, un joystick et un Keypad numérique. Il est possible d'ajouter différentes extensions (volant, clavier, trackball, compatibilité Atari 2600, ...). Sa ludothèque comprend près de 400 titres.

‣ 👤️ Solo
🟢️ Son interface supporte le jeu solo,

‣ 👥️ Multi-joueur / Développement collaboratif
🟢️ Son interface supporte 2 gamepads.


👾️ Gameplay / Usage / Contenu :

‣ ⛳️ Objectif / Thème
⚪️ C'est un émulateur libre de console Colecovision mettant l'accent sur la précision de l'émulation.


‣ 🐥️ Avancement de son développement en : Avril 2024
🟢️ Il/Elle est tout à fait fonctionnel(le).


🧪️ Tests effectués :

‣ 🧫️ Conditions du test, objectif(s)
‣ 🔍️ (v. 1.5.0) : ✔ tested
‣ ◀️ Test de fonctionnement : ✔ tested
‣ 🕵‍♂️️ Test plus précis : ✔ tested
‣ 🏕️ Avec un contenu Commercial : ✔ tested
‣ 🏕️ Avec un contenu Libre ou Gratuit : (🧪️not_tested)
‣ 👤️ Solo : ✔ tested
‣ 👥️ Multi-joueur : ✔ tested

‣ 🎲️ Résultat des tests
‣ 🔍️ (v. 1.5.0) : (⭐⭐⭐)
‣ ◀️ Test de fonctionnement :
🟢️ Visiblement il/elle fonctionne bien.

‣ 👥️ Multi-joueur : (⭐)
⚪️ Le multi-joueur testé (exemples : Space Invaders et Miner 2049er) correspond à du hotseat : les joueurs jouent l'un après l'autre.


‣ 🏕️ Avec un contenu Commercial :

💡 Nota : Certains jeux (exemples : Space Invaders et Miner 2049er) font appel à quelques-unes des 16 touches de la manette numérique de la console Colecovision. Pensez à les définir (voir la section "CONTRÔLES" ci-avant).

🔍️ Congo Bongo : (⭐⭐)
⚪️ Un gameplay similaire à Donkey Kong, le joueur est un explorateur qui tente d'attraper le singe Bongo (en haut de la montagne) qui a mis le feu à sa tente, en escaladant la montagne et en évitant les attaques des animaux.
🟢️ Joli et assez sympa.

🔍️ Space Invaders : (⭐⭐⭐)
⚪️ Un shooter spatial
🟢️ Assez bien réalisé.

🔍️ Miner 2049er : (⭐⭐)
⚪️ Un gameplay similaire à Donkey Kong,
🟢️ Pas trop mal.

🔍️ Donkey Kong : (⭐⭐⭐)
⚪️ L'objectif est d'aider Super Mario à atteindre la plateforme du haut et délivrer sa princesse. La console Colecovision est la 1ere console à proposer ce jeu.
🟢️ Conforme à l'original, de très jolis graphismes, excellent !


🧭️ Conclusion :

🕵️ Impression globale : 👍️
❤️ Like it: 👏️⭐⭐⭐⭐ (excellent)
🎀️ Quality: 🏆️⭐⭐⭐⭐⭐ (perfect)

🟢️ Cet émulateur est lui aussi un émulateur de qualité, offrant des fonctionnalités de confort (interface disponible, support du glisser-déposer de contenu, support du contenu compressé).
🟠️ Dommage qu'elle ne fournit pas de support du BIOS HLE, obligeant à installer un BIOS externe.
🟢️ Son interface est à la fois intuitive et agréable.
🟢️ La compatibilité avec les jeux est excellente (tout à fonctionné).
👏️ ❤️ Un grand bravo et merci (notamment pour la version Linux !) à son/ses auteur(s) !