Gallery

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 12 Open GitHub ↗

Gallery for M5Stack Cardputer ADV Turn your Cardputer into a lightweight photo viewer.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 📸 Gallery for M5Stack Cardputer ADV
Turn your M5Stack Cardputer into a lightweight photo viewer.
Update! V2.0
---

## 📺 Demo
![Project Demo](https://raw.githubusercontent.com/FronTendency/Gallery/main/compressGIF.gif)

## ✨ Features
- Simple Setup: No complex configuration needed.
- SD Card Support: Loads images from a specific folder.
- Optimized for Cardputer: Tailored for the device's display.
- Multi-Folder Navigation: Organize your shots into albums.
  
## 🎉 What's New
- 📁 Folder Support: You can now create multiple albums inside the /Pictures directory.
- 🗂️ Folder Selection Menu: Press the - ' -  key to switch between your photo folders.
- 🖼️ Redesigned UI: All menu panels have been completely overhauled for a cleaner look.
- 🖼️ Format Support: jpg, png, bmp.
- ℹ️ File Info: Press L to see format, weight, and filename.
- ⚙️ Performance improvements and bug fixes.

## 🚀 How to Use

### 1. Prepare your SD Card
- The app now supports a nested directory structure. Create a main folder named Pictures, and inside it, create subfolders for your albums.
```
-Image Requirements:
   Format: Must be in .jpg, .png, or .bmp format.
    Resolution: Optimized for 240 x 135 pixels (16:9 aspect ratio) to fit the Cardputer screen.
    File Size: The preferred image size is up to 600 KB.
    Note: Larger images might work, but they have not been tested yet.
```
> Directory Structure Preview:
![Folder Structure](https://raw.githubusercontent.com/FronTendency/Gallery/main/пикчур.jpg)

```
SD Card Root
└── 📁 Pictures
    ├── 📁 Summer_2025
    │   ├── photo1.jpg
    │   └── photo2.jpg
    └── 📁 Wallpapers
        └── cat.png
```
> **ℹ️ Test Images:**
> In the **Releases** section, you can find a `Picture.zip` archive with sample images.
> Put your images inside the subfolders, not directly in the root /Pictures folder.
### 2. Launch the App
- Insert the SD card into your Cardputer.
- Open the Gallery app and start viewing!
- Use the ' key to select which folder you want to view.

## ⌨️ Controls
```
 < > — Next or Previous image
 [ ] — Skip 10 images Forward or Backward
 ʌ v — Adjust Display Brightness
 i — Show Navigation Help (On-screen info)
 l — Show File Information (format,weight,name)
 ' - Open Folder Selection Menu
```

## 🛠 Installation
1. Download the latest .bin file from the releases page.

2. Flash it via M5Burner or m5launcher (OTA).
 - Search for: Gallery_for_cardputer_ADV
 - Author: @Frontendency
 
👨‍💻 Contacts: 
Developer Telegram: @CardpadADV 
Github: @FronTendency

## ☕Donations☕

If you enjoy using this app and would like to support the author, you can do so here. It's never expected, but always appreciated!

### Fiat money: 
**Euro €**: `5471 2800 3074 6553` 
**Dollar $**: `4454 3000 0486 3970` 
**Ozon Bank ₽**: `2204 3210 6776 2724`

### Crypto: 
**USDT (TRC20)**: `THBaWZtzXBFLypmjoxtERXgVpLJ5fBnbZm` 
**Trust Wallet**: https://link.trustwallet.com/send?coin=195&address=THBaWZtzXBFLypmjoxtERXgVpLJ5fBnbZm&token_id=TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t

**USDT (ERC20)**: `0x1B03AC4310401e7A3026b1539282A4d8F2aeEa87` 
**Trust Wallet**: https://link.trustwallet.com/send?coin=60&address=0x1B03AC4310401e7A3026b1539282A4d8F2aeEa87&token_id=0xdAC17F958D2ee523a2206206994597C13D831ec7

Gallery

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README