A simple GUI application that helps you convert symbolic links (symlinks) to regular files while preserving the original folder structure.
- 🔄 Converts symlinks to actual files
- 📁 Preserves complete folder structure
- 📝 Logs all symlink conversions
⚠️ Error handling and reporting- 🖥️ User-friendly GUI interface
This application is designed to help users who need to convert symbolic links to actual files, which can be useful when:
- Backing up data
- Sharing folders across systems
- Moving data to systems that don't support symlinks
- Creating a clean copy of a directory structure
- Launch the application
- Click "Select Source Folder" to choose the directory containing your symlinks
- Click "Select Destination Folder" to choose where you want the converted files to be saved
- Click "Start Conversion" to begin the process
- Monitor the progress in the logging window
- Review the completion message for any errors or warnings
- Python 3.x
- tkinter (usually comes with Python)
# Clone the repository
git clone https://github.com/yourusername/symlink-converter.git
# Navigate to the directory
cd symlink-converter
# Run the application
python symlink_converter_app.pyThe application:
- Recursively scans the source directory
- Identifies symbolic links using
os.path.islink() - Resolves the actual file path using
os.readlink() - Creates a matching directory structure in the destination
- Copies actual files instead of symlinks
- Maintains regular files as-is
The application handles several error cases:
- Missing source/destination folders
- Non-existent target files
- Permission issues
- Invalid symlinks
All errors are logged and displayed to the user after completion.
Feel free to fork this repository and submit pull requests. You can also open issues for bugs or feature requests.
This project is licensed under the MIT License - see the LICENSE file for details.