Skip to content
Gor3pigPublic

About

A pictogram on the icon of your folders, in your desktop environment (GNOME, KDE Plasma, Cinnamon, MATE, LXQt). A local, free app, installed as a Flatpak.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

95 Commits

Folders and files

Repository files navigation

Custicon

Custicon

A pictogram on the icon of your folders, in your desktop environment.

Your folders, recognizable at a glance.

License: GPL v3 GNOME Python Latest release

English · Français

Website · User guide · Features · Principles · Installation · Contributing

The main window of Custicon

What is Custicon?

Your desktop environment shows the Documents, Music or Pictures folders with a small pictogram in the middle. Custicon lets you do the same for any folder. The pictogram is placed on the real folder icon of your current icon theme, and the content of your folders is never touched.

Features

Choose
Over 6,000 pictograms: Phosphor, emoji, brand logos, your theme, your own file, your own sets of SVG icons or letters. Suggestions follow the folder name.

Adjust
Color from a palette, size and position. Drag the pictogram on the preview, scroll to resize it.

Tint
Give the folder itself the color you want, or the accent color of your system.

Group
Customize several folders at once, with the same pictogram and look.

Regenerate
All icons at once, after a change of theme or accent color.

Undo
A removed icon gives the folder back exactly the one it had before.

Badge
A small colored disc with its own pictogram in a corner of the folder, next to the central one.

Back up
All your folders, styles and favorites in one file, restored in one click on any computer.

Everywhere
GNOME, KDE Plasma, Cinnamon, MATE or LXQt: the right method is chosen automatically.

Read the user guide →
Everything Custicon can do, step by step.

Supported desktops

Desktop File manager Status
GNOME, Budgie Files (Nautilus) Supported
Cinnamon Nemo Supported
MATE Caja Supported
KDE Plasma Dolphin Supported (small hidden .directory file in the folder, removed with the icon)
LXQt PCManFM-Qt Supported (same)
Xfce, LXDE, COSMIC Thunar, PCManFM, COSMIC Files Not supported: these file managers cannot show custom folder icons

The mode is chosen automatically. Each line was checked with the real file manager; other desktops (Pantheon, Deepin) are not verified.

Principles

Your folders' content is never changed · Fully local, no network · Faithful to your theme · Reversible

Installation

1. Set up Flatpak

Fedora, Linux Mint, Pop!_OS and many other distributions ship Flatpak already. On Ubuntu and a few others, follow the official guide for your distribution first, then restart your session.

2. Install Custicon

Open custicon.flatpakref with the Software app, or run this command:

flatpak install --user https://gor3pig.github.io/Custicon/custicon.flatpakref

Flatpak may offer to add Flathub to install the GNOME 51 platform.

3. Stay up to date

Custicon is updated like your other apps: the Software app offers each new version, and every update is signed. The .flatpak file of each version is also attached to its release. More options (release file, uninstall, permissions) are in docs/install.md.

Custicon runs in the Flatpak sandbox with access to your home folder, needed to know the real path of your folders. It has no network access and never modifies the content of your folders.

User guide

The user guide walks you through everything Custicon can do. In the app, it also opens from the main menu or with F1.

Contributing

Custicon is free software and help is welcome: bug reports, ideas, translations and code. docs/development.md explains how to build Custicon and submit a change, and docs/architecture.md (in French) gives an overview of the code.

Licenses

Custicon is free software released under the GNU GPL v3 or later.

The bundled pictograms keep their own licenses:

  • Phosphor Icons, in src/custicon/phosphor/: © 2023 Phosphor Icons, MIT license.
  • Fluent Emoji (monochrome), in src/custicon/emoji/: © Microsoft Corporation, MIT license. Their French names come from the Unicode CLDR, under the Unicode License v3.
  • Simple Icons, in src/custicon/brands/: CC0 1.0. The brands and logos remain the trademarks of their respective owners (see the disclaimer).

About

A pictogram on the icon of your folders, in your desktop environment (GNOME, KDE Plasma, Cinnamon, MATE, LXQt). A local, free app, installed as a Flatpak.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages