https://github.com/valer100/volume-labeler

A simple tool for changing the label and the icon of a volume in Windows.
https://github.com/valer100/volume-labeler

drive drive-icon drive-label icon label python volume volume-icon volume-label windows windows-10 windows-11 windows10 windows11

Last synced: 6 months ago
JSON representation

A simple tool for changing the label and the icon of a volume in Windows.

• Host: GitHub
• URL: https://github.com/valer100/volume-labeler
• Owner: Valer100
• License: mit
• Created: 2025-01-10T13:10:27.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-04-15T13:00:53.000Z (6 months ago)
• Last Synced: 2025-04-15T14:21:42.117Z (6 months ago)
• Topics: drive, drive-icon, drive-label, icon, label, python, volume, volume-icon, volume-label, windows, windows-10, windows-11, windows10, windows11
• Language: Python
• Homepage:
• Size: 4.98 MB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

          


    



# Volume Labeler

[![Release](https://img.shields.io/github/v/release/Valer100/Volume-Labeler?label=stable)](https://github.com/Valer100/Volume-Labeler/releases/latest)

[![Pre-release](https://img.shields.io/github/v/release/Valer100/Volume-Labeler?include_prereleases&label=pre-release)](https://github.com/Valer100/Volume-Labeler/releases)

[![Windows](https://img.shields.io/badge/windows-10+-blue)]()

[![Architecture](https://img.shields.io/badge/architecture-x64-blue)]()

[![Build status](https://img.shields.io/github/actions/workflow/status/Valer100/Volume-Labeler/build.yml)](https://github.com/Valer100/Volume-Labeler/actions/workflows/build.yml)

[![Downloads](https://img.shields.io/github/downloads/Valer100/Volume-Labeler/total)](https://github.com/Valer100/Volume-Labeler/releases)

[![Stars](https://img.shields.io/github/stars/Valer100/Volume-Labeler?style=flat&color=yellow)](https://github.com/Valer100/Volume-Labeler/stargazers)

[![Contributors](https://img.shields.io/github/contributors/Valer100/Volume-Labeler)](https://github.com/Valer100/Volume-Labeler/graphs/contributors)

[![Last commit](https://img.shields.io/github/last-commit/Valer100/Volume-Labeler)](https://github.com/Valer100/Volume-Labeler/commits/main)

[![Commits since latest release](https://img.shields.io/github/commits-since/Valer100/Volume-Labeler/latest)](https://github.com/Valer100/Volume-Labeler/commits/main)

[![License](https://img.shields.io/github/license/Valer100/Volume-Labeler)](https://github.com/Valer100/Volume-Labeler/blob/main/LICENSE)

A simple tool for changing the label and the icon of a volume in Windows. It makes these changes by creating an `autorun.inf` file (or edits the existing one) on the volume you want to change its label and icon. 

![From -> To Image](assets//from_to_dark.png#gh-dark-mode-only)

![From -> To Image](assets//from_to_light.png#gh-light-mode-only)

## ✨ Features

- When selecting a volume, it checks if `autorun.inf` is present on it. It then retrieves its actual label and icon, so you don't have to type the same label if you only want to change the volume's icon or select the same icon if you only want to change the volume's label.

- Multiple icon options: default icon, custom icon (`.ico` or from an `.exe`, `.dll` or `.icl` file) or icon from image (converts the selected image to an `.ico` file).

- Refresh volume information in the File Explorer after applying the changes (requires running the app as administrator and not using the volume; doesn't work with the system drive)

- Option to hide the `autorun.inf` file and the `vl_icon` folder (the icon is stored in that folder).

- Option to backup the `autorun.inf` file for easily restoring it later if something wents wrong or you want to revert your changes to a previous point.

- Option to get rid of all customizations (including the ones not made by Volume Labeler).

- Entry in the volumes' right click context menu for easily customizing volumes (available only in the classic context menu at the moment). 

- Light and dark themes and localization support.

## 📷 Screenshots

| ☀️ Light Mode | 🌛 Dark Mode |

|:------------:|:------------:|

| ![Light mode](assets/screenshots/screenshot_light.png) | ![Dark mode](assets/screenshots/screenshot_dark.png) |

## ▶️ Running from source

Before running from the source, you must install the dependencies. To do that, open Command Prompt in the folder of the cloned repository and run the following command:

```

pip install -r requirements.txt

```

After that, open the `main.pyw` file.

## 🏗️ Building

### Building the app

Just run `build_app.bat`. It will do everything needed to build the app. After the build process is done, you can find the built app in a `build` folder (or in a `dist` folder if the renaming process fails).

### Building the installer

Before building the installer, you must install Inno Setup Compiler on your computer. You can download it [here](https://jrsoftware.org/isdl.php/).

Also, you must build the app first before building the installer. After building the app, make sure a `build` folder appears. If it doesn't and  a `dist` folder appears intstead, rename that folder to `build`. After that, right-click `build_installer_x86.iss`, `build_installer_x64.iss` or `build_installer_arm64.iss` (depending on your CPU's architecture) and choose `Compile`. After the installer was built, you can find it in the same `build` folder.

## 💿 Download

At the moment, there are no stable realeses published. However, if you want to try unstable versions, you can check out the builds from [GitHub Actions](https://github.com/Valer100/Volume-Labeler/actions).



    



## 📜 License

Volume Labeler is MIT-licensed. You can read the license text [here](https://github.com/Valer100/Volume-Labeler/blob/main/LICENSE).