215111 Stack

2026-05-13 01:57:17

The Ultimate Portable Linux Computer: Inside the Altoids Tin Cyberdeck

Discover the Altoids tin cyberdeck: a Pi Zero-powered Linux laptop in a mint tin with custom keyboard, SPI display, and USB port.

Welcome to the cutting edge of pocket-sized computing. For years, the Hackaday community has showcased ingenious projects crammed into Altoids tins, alongside a steady stream of cyberdecks. But only recently have these two worlds collided in a truly remarkable way. [Exercising Ingenuity] has created a fully functional Linux computer housed in an Altoids tin, resembling a miniature clamshell laptop. This tiny marvel packs a Raspberry Pi Zero, a custom keyboard, and a SPI display into a mint-tin enclosure, proving that big ideas can come in small, nostalgic packages.

What exactly is the Altoids tin cyberdeck project?

This project combines the iconic Altoids tin enclosure with a fully operational Linux computer, creating what looks like a tiny clamshell laptop. It is not merely a novelty; it runs a full Linux distribution (specifically, an older version of Raspberry Pi OS) and serves as a functional, portable computing device. The builder, known as [Exercising Ingenuity], designed it to be as integrated as possible, with a custom keyboard, a USB port, and broken-out GPIO headers. The entire system was assembled with careful attention to making the tin close properly, which required modifying the Altoids tin’s hinges.

The Ultimate Portable Linux Computer: Inside the Altoids Tin Cyberdeck
Source: hackaday.com

What hardware components are used in this build?

The core of the cyberdeck is a Raspberry Pi Zero, a popular single-board computer known for its small size. It is paired with a UPS PHAT, which provides power management and battery backup, allowing for portable operation. The display is an SPI screen, chosen for its low pin count and compatibility with the Pi. But perhaps the most distinctive hardware element is the homemade keyboard, which is custom-built to fit the tight confines of the Altoids tin. Additionally, the build includes a full-size USB port for connecting peripherals and a header that breaks out several GPIO pins for expansion or external sensor connections.

What makes the keyboard in this project so special?

The keyboard is arguably the defining feature of this build. Unlike using a pre-made mini keyboard, [Exercising Ingenuity] crafted a custom keyboard from scratch to fit precisely within the Altoids tin’s dimensions. This involved designing a key matrix, sourcing membrane or mechanical keyswitches that are thin enough, and ensuring reliable electrical connections to the Pi Zero. The result is a fully functional input device that feels like a miniature laptop keyboard, enabling text entry, command-line work, and even light coding. This level of integration is rare in tiny computer builds, as it requires significant patience and soldering skill.

What challenges did the builder face during construction?

Creating a compact computer inside an Altoids tin naturally comes with obstacles. The most obvious was making the tin close properly. The original hinges did not accommodate the thickness of the internal components, so they had to be modified or replaced to allow the lid to sit flush. Another significant challenge involved the SPI display driver. The screen required a specific older version of the Raspberry Pi operating system to function correctly, forcing the builder to use a legacy OS rather than the latest release. Despite these hiccups, the project succeeded, and the builder notes that minor quirks like these are acceptable tradeoffs given the extreme miniaturization achieved.

The Ultimate Portable Linux Computer: Inside the Altoids Tin Cyberdeck
Source: hackaday.com

How does this compare to other tiny laptops or cyberdecks?

While there have been many miniature laptops and cyberdecks built over the years, this project stands out for its level of integration within such a small, standard enclosure. Previous tiny laptops often relied on larger cases or external keyboards; here, everything fits into a commodity Altoids tin without bulging. The custom keyboard, the UPS PHAT for battery power, and the carefully selected SPI display all work together as a unified system. It is not just a proof of concept—it demonstrates that a usable Linux machine can be compressed to fit in your pocket, ready for writing, coding, or tinkering on the go.

What software and operating system does it run?

The Altoids tin cyberdeck runs Linux, specifically an older version of Raspberry Pi OS. This choice was mandated by the display driver, which required a deprecated kernel or library version to properly drive the SPI screen. The OS provides a full desktop environment or can be used from the command line. Because the Pi Zero has limited RAM and processing power, the system is best suited for lightweight tasks, such as text editing, simple programming, or retro gaming emulation. However, it effectively demonstrates that even a system confined to a mint can run a real operating system with networking and USB peripherals.

What connectivity and expansion options does it offer?

Despite its tiny size, the cyberdeck includes a full-size USB port for connecting a mouse, storage, or even a network adapter. The GPIO pins are broken out to a header, enabling connection to sensors, LEDs, or other external electronics—useful for IoT projects or hardware hacking. The UPS PHAT also provides a power-over-USB input for charging and a battery fuel gauge. Since it runs Linux, the system supports Wi-Fi via a dongle or internal module if added, making it capable of browsing the web (within reason) or communicating with other devices. This expansion potential turns the Altoids tin into a versatile mobile computer, not just a static display piece.