https://github.com/beyenilmez/iconium

A tool for creating, applying, customizing and sharing icon packs for files and folders.
https://github.com/beyenilmez/iconium

app icon-pack icons wails wails-app

Last synced: 5 months ago
JSON representation

A tool for creating, applying, customizing and sharing icon packs for files and folders.

• Host: GitHub
• URL: https://github.com/beyenilmez/iconium
• Owner: beyenilmez
• License: mit
• Created: 2024-04-05T19:28:16.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-09-06T10:37:39.000Z (over 1 year ago)
• Last Synced: 2025-09-28T09:58:56.761Z (8 months ago)
• Topics: app, icon-pack, icons, wails, wails-app
• Language: TypeScript
• Homepage: https://beyenilmez.github.io/iconium/
• Size: 51.7 MB
• Stars: 10
• Watchers: 1
• Forks: 3
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# 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](#iconium)

  - [Table of Contents](#table-of-contents)

  - [Screenshots](#screenshots)

  - [Features](#features)

  - [Planned Features](#planned-features)

  - [Installation](#installation)

  - [Translation](#translation)

  - [Technologies](#technologies)

  - [License](#license)

## Screenshots

![Screenshot 1](./assets/screenshot-1.png)

![Screenshot 2](./assets/screenshot-2.png)

![Screenshot 3](./assets/screenshot-3.png)

## 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](https://wails.io/docs/gettingstarted/installation).

   

2. Clone the repository:

   ```bash

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

   ```

3. Navigate to the project directory:

   ```bash

   cd iconium

   ```

4. Run in dev mode:

   ```bash

   wails dev

   ```

   or

   

    Build:

   ```bash

   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](https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oe376/6c085406-a698-4e12-9d4d-c3b0ee3dbc4a). 

2. Translate the file to your language.

3. Update `frontend/src/locales.json` to include your language.

## Technologies

- **Backend**: [Go](https://go.dev/), [Wails](https://wails.io/)

- **Frontend**: [React](https://react.dev/), [TailwindCSS](https://tailwindcss.com/), [shadcnUI](https://ui.shadcn.com/)

- **Icon Processing**: [ImageMagick](https://imagemagick.org/), [ExtractIcon](https://github.com/bertjohnson/ExtractIcon)

- **Translation**: [i18next](https://react.i18next.com/)

## License

Distributed under the MIT License. See [LICENSE](https://github.com/beyenilmez/iconium/blob/main/LICENSE) for more information.