https://github.com/mathew005/linkforge
A python-window GUI Application for creating a junction folder in windows, using mklink.
https://github.com/mathew005/linkforge
application junction mklink python utility utility-application windows
Last synced: about 1 month ago
JSON representation
A python-window GUI Application for creating a junction folder in windows, using mklink.
- Host: GitHub
- URL: https://github.com/mathew005/linkforge
- Owner: Mathew005
- License: mit
- Created: 2025-04-01T18:27:26.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-01T18:48:33.000Z (about 1 year ago)
- Last Synced: 2025-04-01T19:39:38.591Z (about 1 year ago)
- Topics: application, junction, mklink, python, utility, utility-application, windows
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# LinkForge
**LinkForge** is a modern, cross-platform desktop application for managing file system links. It provides an intuitive interface for creating **Junctions**, **Symbolic Links**, and **Hard Links**, and tracks your history.
Built with **CustomTkinter**, LinkForge offers a sleek, dark-themed UI that works on both **Windows** and **Linux**.
## Features
- **Cross-Platform:** Works on Windows (mklink) and Linux (ln -s).
- **Multiple Link Types:**
- **Junctions** (Dir Symlinks on Linux)
- **Symbolic Links** (Files & Directories)
- **Hard Links**
- **History Panel:** Tracks all created links for easy reference.
- **Admin Awareness:** Automatically detects when Admin/Root privileges are needed.
- **Modern UI:** Clean, dark-themed interface with tooltips and responsive design.
## Installation
### 1. Using Pip (Recommended)
You can install LinkForge directly from source:
```bash
pip install .
# Then run:
linkforge
```
### 2. Standalone Executable
Download the latest release for your OS from the [Releases Page](https://github.com/Mathew005/LinkForge/releases).
**Windows:**
- Run `LinkForge.exe`.
**Linux:**
- Run `./LinkForge`.
### 3. From Source
1. Clone the repository:
```bash
git clone https://github.com/Mathew005/LinkForge.git
cd LinkForge
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the application:
```bash
python main.py
```
## Usage
1. **Select Source Path:** The file or folder you want to link to.
2. **Select Link Parent:** The folder where you want to create the link.
3. **Link Name:** The name of the new link.
4. **Choose Type:** Select Junction, Symlink, or Hardlink.
5. **Create:** Click "Create Link".
## Building from Source
To create a standalone executable for your platform:
**Windows:**
```bat
scripts\build_windows.bat
```
**Linux:**
```bash
chmod +x scripts/build_linux.sh
scripts/build_linux.sh
```
EXECUTABLES will be found in the `dist` folder.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contributing
Contributions are welcome! Please open an issue or pull request.