https://github.com/blazingvx/iconmapper

IconMapper is a Windows Forms application that enables users to customize folder icons on their Windows system. It features a tree view for browsing drives and folders, and a list of icons that can be applied to the selected folder. Ideal for those looking to personalize their file system with custom icons.
https://github.com/blazingvx/iconmapper

csharp windowsforms

Last synced: 2 months ago
JSON representation

IconMapper is a Windows Forms application that enables users to customize folder icons on their Windows system. It features a tree view for browsing drives and folders, and a list of icons that can be applied to the selected folder. Ideal for those looking to personalize their file system with custom icons.

• Host: GitHub
• URL: https://github.com/blazingvx/iconmapper
• Owner: blazingvx
• License: mit
• Created: 2024-09-01T10:26:33.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2025-06-06T12:24:44.000Z (about 1 year ago)
• Last Synced: 2025-06-06T13:27:13.724Z (about 1 year ago)
• Topics: csharp, windowsforms
• Language: C#
• Homepage: https://medium.com/@vedantsoodblog/iconmapper-simplify-customizing-folder-icons-on-windows-3f03198555c7
• Size: 134 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# IconMapper

[![stability](https://img.shields.io/badge/stability-experimental-orange.svg)](https://github.com/blazingvx/IconMapper)

![GitHub](https://img.shields.io/github/license/blazingvx/IconMapper?style=plastic)

**IconMapper** is a Windows Forms application that allows users to apply custom icons to folders on their system. The application provides a user-friendly interface to select and apply icons from a specified directory to the chosen folders.

![application_image](./Screenshot/Application_Preview.png)

## Features

- Load and display available drives and folders in a tree view.

- Select and apply `.ico` files as icons for folders.

- Preview selected icons before applying them.

- Import multiple `.ico` files directly into the icon folder.

- Update the icon folder path through a settings menu.

- Help and about dialogs for user guidance.

- Refresh folder view to reflect icon changes immediately.

## Getting Started

### Prerequisites

- .NET Framework (version specified in the project)

- Visual Studio (for building and running the project)

- PowerShell (for executing the script to update folder icons)

### Installation

1. **Clone the Repository**

   ```bash

   git clone https://github.com/blazingvx/IconMapper.git

   cd IconMapper

    ```

2. **Configure Icon Folder Path**

    Open App.config and add the path to your .ico files. Update the IconFolderPath entry:

   ```bash

    

        

    

3. **Build and Run**

    Open the project in Visual Studio and build it using the following steps:

    - Open Solution Explorer.

    - Right-click on the solution and select Build.

4. **Create Installer**

    To create a new installer for the application using Visual Studio Installer Project:

    - Right-click on your solution in Solution Explorer and choose Add > New Project.

    - Select Setup Project under the Other Project Types > Setup and Deployment category.

    - Add the main project output to the installer project.

    - Configure the installer project settings as needed (e.g., add shortcuts, custom actions).

    - Build the installer project to generate the setup file (Can be created using existing setup project).

### Future Enhancements

We plan to introduce the following features in future updates:

- Consider adding a feature for deleting icons from the icon folder.

- Explore the possibility of adding more icon formats for import.

### Change Log

For a detailed list of changes and updates, please refer to the [Change Log](./docs/ChangeLog.md).

### Reference

For a detailed blog post on how this application was developed, visit this [Medium article](https://medium.com/@vedantsoodblog/iconmapper-simplify-customizing-folder-icons-on-windows-3f03198555c7).

### License

This project is licensed under the terms of the [MIT License](LICENSE).

### Contributing

We welcome contributions to this project! If you have suggestions, bug fixes, or improvements, please follow these guidelines:

- Fork the repository and clone your fork.

- Create a new branch for your changes.

- Commit your changes with clear, descriptive messages.

- Push your changes to your fork and create a pull request.

- Please ensure your code follows the existing style and includes tests where applicable.

## Contact

For any inquiries or issues, please open an issue on the [GitHub repository](https://github.com/blazingvx/IconMapper/issues).