https://github.com/germabyte/namefixer

namefixer.py is a user-friendly desktop application designed to help you analyze and standardize the names of files and folders in a selected directory. It ensures your file and folder names adhere to standard naming conventions by identifying and replacing emojis and non-standard characters that may cause compatibility or usability issues.
https://github.com/germabyte/namefixer

cross-platform emoji file-management file-system folder-management gui python renaming special-characters tkinter

Last synced: about 22 hours ago
JSON representation

namefixer.py is a user-friendly desktop application designed to help you analyze and standardize the names of files and folders in a selected directory. It ensures your file and folder names adhere to standard naming conventions by identifying and replacing emojis and non-standard characters that may cause compatibility or usability issues.

• Host: GitHub
• URL: https://github.com/germabyte/namefixer
• Owner: germabyte
• Created: 2025-01-02T21:54:58.000Z (25 days ago)
• Default Branch: main
• Last Pushed: 2025-01-04T14:18:13.000Z (24 days ago)
• Last Synced: 2025-01-10T02:23:08.888Z (18 days ago)
• Topics: cross-platform, emoji, file-management, file-system, folder-management, gui, python, renaming, special-characters, tkinter
• Language: Python
• Homepage:
• Size: 6.84 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# File & Folder Name Standardizer

**namefixer.py** is a user-friendly desktop application designed to help you analyze and standardize the names of files and folders in a selected directory. It ensures your file and folder names adhere to standard naming conventions by identifying and replacing emojis and non-standard characters that may cause compatibility or usability issues.

---

## **Features and Benefits**

- **Detect and Replace Emojis**: Identify file or folder names containing emojis and replace them with your preferred character or string.

- **Identify Non-Standard Characters**: Find characters that are problematic for file systems (e.g., `<`, `>`, `|`) and replace them easily.

- **Batch Processing**: Analyze and fix multiple files and folders at once.

- **Exportable Results**: Save the analysis results to a CSV file for documentation or further review.

- **Intuitive GUI**: Simple, clean interface for easy navigation and functionality.

---

## **Getting Started**

Follow these steps to download, set up, and use the application:

1. **Download the Application**:

   - Locate the **"Code"** button on the repository page.

   - Select **Download ZIP** and save it to your computer.

2. **Extract the Files**:

   - Locate the downloaded ZIP file on your computer.

   - Right-click the ZIP file and select **Extract All** (or use your preferred extraction tool).

   - Choose a destination folder and extract the contents.

3. **Run the Program**:

   - Navigate to the extracted folder.

   - Double-click on `namefixer.py` to launch the application.

> **Note**: Ensure you have Python 3.x installed on your computer. If not, download it from [python.org](https://www.python.org/).

---

## **Use Cases and Examples**

Here are some practical scenarios where this tool can be helpful:

### 1. **Preparing Files for Cloud Storage**

You plan to upload files to a cloud service that restricts certain characters in file names. Use **namefixer.py** to ensure all file names meet these requirements.

### 2. **Sharing Files Across Platforms**

When sharing files between Windows, macOS, or Linux, some characters may cause compatibility issues. Standardize names for seamless sharing.

### 3. **Organizing Digital Archives**

Clean up your directories by replacing emojis and other problematic characters for easier management and searchability.

---

## **How to Use the Application**

1. **Select a Folder**:

   - Click **Browse** to choose the folder you want to analyze.

2. **Set Replacement Values**:

   - Enter the character or string to replace emojis.

   - Enter the character or string to replace non-standard characters.

3. **Analyze**:

   - Click **Start Analysis** to identify files and folders with issues.

   - View the results in the table provided.

4. **Replace**:

   - Click **Replace Issues** to standardize names based on the replacement values.

5. **Export Results**:

   - Save the analysis results by clicking **Export Results**.

---

## **Disclaimers and Updates**

- **Ongoing Updates**: This repository may receive updates or changes, and these updates may render parts of this README file outdated.

- **README Accuracy**: There is no guarantee that this README will be updated to reflect future changes. Please refer to the latest source code or documentation in the repository for the most accurate information.

---

**Enjoy a hassle-free way to organize your file and folder names!**