Step 1: Download the Latest Version

Download the latest version of TSTP Drive Mapper from the official website.

Step 2: Extract the Files

Unzip the downloaded archive and save the contents to your desired directory.

Step 3: Launch the Application

Execute the Drive_Mapper.exe file to start using the application.

System Requirements

• Operating System: Windows 10/11
• Permissions: Administrator privileges may be required for certain operations.

1. Adding a New Drive

1. Click on the “Add Drive” button.
2. Choose an available drive letter from the dropdown menu.
3. Enter the UNC path (e.g., \\server\share).
4. If required, enter the necessary credentials.
5. Click “Save” to add the drive to your list.

2. Editing an Existing Drive

1. Select the drive you wish to edit by checking the corresponding checkbox.
2. Click the “Edit Drive” button.
3. Modify the necessary details in the dialog that appears.
4. Click “Save” to apply the changes. If the drive is currently mapped, it will be unmapped and remapped with the new settings.

3. Removing a Drive

1. Select the drive(s) you want to remove by checking the checkbox.
2. Click the “Remove Drive” button.
3. Confirm the removal in the prompt. If the drive is mapped, it will be unmapped before removal.

4. Mapping and Unmapping Drives

• Map Drives: Click the “Map Drives” button to connect all selected drives. You can select specific drives or choose to map all drives in the list.
• Unmap Drives: Click the “Unmap Drives” button to disconnect all selected drives. Similar to mapping, you can select specific drives or unmap all.

5. Checking Drive Status

• Click the “Check Drives” button to verify the current status of all drive mappings. The “Mapped” column will indicate whether each drive is currently connected.

6. Exporting Drive Mappings

• Navigate to File > Export Drives to export your drive mappings as JSON or XML files. These files can be used for automation or shared with others.

7. Accessing Logs

• The log console at the bottom of the main window displays real-time logs of all operations.
• Save Log: Navigate to File > Save Log to export logs in various formats.
• Clear Log: Navigate to File > Clear Log to clear the log history.
• Toggle Console: Navigate to File > Toggle Console to show or hide the console.

8. Settings

• Adjust your preferences under the Settings menu.
• Startup Settings: Enable the application to start on Windows startup.
• Auto Re-Add Drives: Automatically re-add drives upon startup.
• Theme Selection: Switch between light and dark themes to suit your preference.

9. System Tray Integration

• The application minimizes to the system tray, allowing you to access quick controls and settings without occupying space on your taskbar.
• Right-Click Tray Icon: Open the main window, toggle startup settings, switch themes, or exit the application.

• Programming Language: Python 3.8
• Development Environment: Cursor / VS Code
• Build Tools: PyInstaller
• Version: 1.0.0
• License: MIT License

Building from GitHub

1. Clone the Repository:

   git clone https://github.com/TSTP-Enterprises/TSTP-Drive_Mapper.git
   cd TSTP-Drive_Mapper

2. Install Python and Dependencies:

   Ensure you have Python 3.8 installed on your system. Install the required Python packages using the requirements.txt file:

   pip install -r requirements.txt

3. Required Imports:

   The application uses several Python modules and PyQt5 for the GUI. Ensure the following imports are available in your environment:

   
   import sys
   import os
   import json
   import logging
   import requests
   import subprocess
   import urllib.request
   from datetime import datetime
   from PyQt5.QtWidgets import (
       QApplication, QMainWindow, QPushButton, QTextEdit, QVBoxLayout, 
       QWidget, QDialog, QHBoxLayout, QLabel, QLineEdit, QMessageBox,
       QTableWidget, QTableWidgetItem, QHeaderView, QAbstractItemView, 
       QFileDialog, QCheckBox, QSystemTrayIcon, QMenu, QStyle, QSizePolicy,
       QScrollArea, QFrame, QComboBox, QAction,  QGraphicsDropShadowEffect, 
   )
   from PyQt5.QtCore import Qt, QThread, pyqtSignal, QDateTime, QUrl
   from PyQt5.QtGui import QIcon, QColor, QBrush, QDesktopServices
                       

4. Build the Executable:

   Use PyInstaller to create a standalone executable of the application:

   pyinstaller --onefile --windowed Code/main.py

5. Run the Application:

   After building, the executable will be located in the dist directory. You can run it to start the application:

   ./dist/main

TSTP Drive Mapper was developed to address a critical need for a client who frequently had to remap network drives due to connecting with different profiles to their VPN both while away from work and at the office. The existing process was time-consuming and prone to errors, disrupting productivity and workflow.

Development Process:

1. Requirement Analysis: Identified the core requirements for efficient drive mapping and automatic remapping based on VPN profiles.
2. Design: Crafted an intuitive user interface that allows for easy management of network drives, batch operations, and secure credential storage.
3. Implementation: Utilized Python and PyQt5 for scripting the drive mapping functionalities, ensuring compatibility with Windows 10/11 systems.
4. Testing: Conducted rigorous testing to ensure reliability, security, and ease of use. Feedback from initial users was incorporated to refine features.
5. Deployment: Packaged the tool into an executable using PyInstaller for seamless installation and usage across various environments.

Why It Was Made:

The primary goal was to create a reliable tool that automates the tedious process of remapping network drives, especially in environments where VPN profiles change frequently. By automating this process, TSTP Drive Mapper reduces the potential for human error, saves valuable time, and enhances overall productivity.

We welcome contributions to enhance TSTP Drive Mapper! Whether it’s reporting a bug, suggesting a feature, or submitting a pull request, your input is invaluable.

1. Fork the Repository: Click the Fork button at the top-right corner of the repository page.
2. Create a Feature Branch:

   git checkout -b feature/YourFeature

3. Commit Your Changes:

   git commit -m "Add YourFeature"

4. Push to the Branch:

   git push origin feature/YourFeature

5. Open a Pull Request: Navigate to the repository on GitHub and click New Pull Request.

For detailed guidelines, refer to our Contributing Guidelines.

Your support helps us maintain and improve TSTP Drive Mapper. As a free and open-source tool, donations help cover development costs and ensure the project remains sustainable.

If you find this tool valuable, please consider supporting us via PayPal.

Your contributions are greatly appreciated and help us continue providing this essential tool to the community.

This project is licensed under the MIT License.

TSTP Drive Mapper is open-source, free to use, and does not offer any packages, plans, or additional services.

• Official Website: TSTP Website
• GitHub Organization: TSTP-Enterprises
• LinkedIn: TSTP LinkedIn
• YouTube Channel: (TSTP) YourPST Studios
• Facebook Page: TSTP Solutions
• GitHub Repository: TSTP-Drive_Mapper
• Software Page: TSTP Drive Mapper Software
• Download Link: Download TSTP Drive Mapper

A heartfelt thank you to all the users who have supported TSTP Drive Mapper. Your feedback and encouragement drive us to continuously improve and provide the best possible tool for managing network drives.