README.md

Iconium

Website

Iconium is a flexible tool for creating and managing icon packs. Iconium can apply icons to .lnk, .url and directories and extract them from files such as .png, .jpg, .jpeg, .webp, .svg, .bmp, .ico, .exe, .lnk and .url files. It also provides advanced features like file matching with environment variables or wildcards and customizing icon radius and opacity.

Table of Contents

• Iconium
  • Table of Contents
  • Screenshots
  • Features
  • Planned Features
  • Installation
  • Translation
  • Technologies
  • License

Screenshots

Features

• Create, distribute and use icon packs
• Edit icon radius and opacity
• Match files by environment variables, wildcards, or destination paths
• Supports .lnk, .url, and directories
• Can extract icons from .png, .jpg, .jpeg, .webp, .svg, .bmp, .ico, .exe, .lnk and .url files
• Highly customizable appearance
• Automatic update
• Color schemes and light/dark mode for each scheme

Planned Features

• Save desktop layouts to icon packs
• Auto-apply scheduling for icon packs
• Custom icon masks

Installation

1. Install Wails: Wails installation guide.

2. Clone the repository:

   git clone https://github.com/beyenilmez/iconium.git

3. Navigate to the project directory:

   cd iconium

4. Run in dev mode:

   wails dev

   or

   Build:

   wails build

Translation

1. Create a copy of frontend/public/locales/en-US.json file and rename it using your language code, which you can find here.
2. Translate the file to your language.
3. Update frontend/src/locales.json to include your language.

Technologies

• Backend: Go, Wails
• Frontend: React, TailwindCSS, shadcnUI
• Icon Processing: ImageMagick, ExtractIcon
• Translation: i18next

License

Distributed under the MIT License. See LICENSE for more information.