---
title: Pixelfin
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, photos, pixel-art, niche, gallery, self-hosted, web]
confidence: medium
contested: false
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/pixelfin/pixelfin]
---

# 📸 Pixelfin

> **Galerie photos spécialisée pixel art** : visualisez et partagez vos créations pixelisées (sprites, tilesets, illustrations rétro) avec un viewer qui respecte le rendu net.

## 📋 Informations Générales

| Attribut | Valeur |
|----------|--------|
| **Nom** | Pixelfin |
| **Slug** | app-pixelfin |
| **Description** | Galerie d'images spécialisée pixel art |
| **Site officiel** | [pixelfin.app](https://pixelfin.app) |
| **Repository** | [pixelfin/pixelfin](https://github.com/pixelfin/pixelfin) |
| **Stars** | 151 ⭐ |
| **Licence** | MIT |
| **Langage principal** | TypeScript, Svelte |
| **Catégorie** | Photos |
| **Tags** | [catalogue, photos, pixel-art, niche, gallery, self-hosted, web] |

## 📝 Description

⚠️ **Fiche confiance basse** : Pixelfin est un projet de **niche** (~150 étoiles), sans garantie de maintenance long terme. À utiliser en connaissance de cause.

**Pixelfin** est une galerie web spécialisée dans l'affichage de **pixel art** et petites images raster. Le problème des galeries classiques : elles upscalent les images avec du bilinear/bicubic smoothing, ce qui **floute** le pixel art. Pixelfin utilise des algorithmes de mise à l'échelle **nearest-neighbor** ou **HQ2x/HQ4x** pour préserver la netteté du pixel.

Fonctionnalités : **rendu pixel-perfect** (pas de smoothing), **zoomer 1x, 2x, 4x, 8x** sans perte, **algorithmes HQ** (HQ2x, HQ4x, xBRZ) pour upscale qualitatif, **viewer grille** pour comparer sprites côte à côte, **palette inspection** (extraction des couleurs uniques), **support PNG-8/PNG-24/PNG-32 avec palette**, **GIF animé** (lecture frame par frame), **tags** par projet/sprite set, **API** d'upload.

Cas d'usage : **game devs indie** qui veulent présenter leurs tilesets/sprites, **artistes pixel** qui exposent leur portfolio, **rétro-gaming** (scans d'assets d'anciens jeux), **pixel art challenges** (DailyPixel, etc.).

⚠️ **Limites** : le projet est petit, peu de documentation, peu de releases. À envisager comme un **point de départ** à forker si vous avez un vrai besoin.

## 🚀 Installation

### Via Docker

```yaml
# docker-compose.yml
services:
  pixelfin:
    image: ghcr.io/pixelfin/pixelfin:latest
    container_name: pixelfin
    restart: unless-stopped
    volumes:
      - /mnt/pixelart:/app/images:ro
      - pixelfin-data:/app/data
    ports:
      - 8092:8080
```

### Installation manuelle

```bash
git clone https://github.com/pixelfin/pixelfin.git
cd pixelfin
npm install
npm run build
# Servir dist/ via nginx
```

## ⚙️ Configuration

- **Dossier images** : montage du dossier contenant le pixel art.
- **Algorithme d'upscale** : choisir dans l'UI (nearest, HQ2x, HQ4x, xBRZ).
- **Palette inspection** : activer pour les PNG indexés.

## 🔗 Alternatives

- **[[app-pigallery2]]** — Galerie générique très performante (sans optimisation pixel)
- **[[app-foldergram]]** — Galerie dossier simple
- **[[app-photonix]]** — Si vous voulez de l'IA sur du pixel art

## 🔒 Sécurité

- **Lecture seule** : `:ro` sur le dossier d'images.
- **Pas d'auth par défaut** : activer basic auth si exposition non-LAN.
- **HTTPS** : recommandé.
- **Surface limitée** : app statique.

## 📚 Ressources

- [Site officiel](https://pixelfin.app)
- [Repository GitHub](https://github.com/pixelfin/pixelfin)
- [Documentation limitée](https://github.com/pixelfin/pixelfin/blob/main/README.md)

## 🔗 Pages Liées
- [[cat-photos]]
- [[app-pigallery2]]
- [[app-foldergram]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]