Skip to content

sprinteroz/Linux-NTFS-Manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

80 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

NTFS Manager - Professional NTFS Drive Management for Linux

NTFS Manager Logo

CI Dependency Review Security Policy License: Dual Version

πŸ”΄ Frustrated by "NTFS Drive is Read-Only" Errors?

You're not alone. Millions of dual-boot Linux users face this every day:

"Help! My external drive suddenly became read-only!"
"I can see my files but can't copy anything to the drive!"
"Why does my Windows partition mount read-only in Linux?"

πŸ€” Why This Happens

When Windows 10/11 "shuts down" with Fast Startup enabled (the default), it's actually hibernating. This leaves your NTFS drives in a "hibernated" state with a dirty bit set.

Linux's ntfs-3g driver correctly refuses to mount these drives read-write to protect your data from corruption. You'll see errors like:

  • The disk contains an unclean file system
  • Metadata kept in Windows cache, refused to mount
  • Mount is denied because the NTFS volume is in an unsafe state

βœ… The Solution

Linux NTFS Manager makes fixing this simple and safe:

  • 🎯 One-Click Fix - Safely removes the Windows hibernation flag
  • πŸ“š Educational - Explains what's wrong and why (not just "click here")
  • πŸ›‘οΈ Safe - No data loss, no force-mounting, no dangerous flags
  • 🌍 32 Languages - Helps users worldwide understand NTFS issues
  • πŸ”„ Prevents Recurrence - Guides you to disable Fast Startup permanently

No more rebooting to Windows just to shut it down properly.
No more searching forums for ntfsfix commands.
No more panicking about "lost" files.


🚨 CRITICAL WARNING: Known Incompatible Software

⚠️ Balena Etcher Breaks NTFS Functionality

DO NOT INSTALL BALENA ETCHER if you need NTFS drive functionality!

Balena Etcher modifies system-level permissions that break:

  • ❌ NTFS drive mounting
  • ❌ Writing to NTFS partitions
  • ❌ NTFS drive formatting
  • ❌ Hot-swap functionality
  • ❌ May also affect network connectivity and Node.js

If you've already installed balena Etcher and are experiencing NTFS issues:

# Run our recovery script to fix the damage
cd Linux-NTFS-Manager
sudo ./scripts/balena-etcher-recovery.sh

Safe Alternatives to Balena Etcher:

  • βœ… GNOME Disks (recommended): sudo apt install gnome-disk-utility
  • βœ… Popsicle: sudo apt install popsicle-gtk
  • βœ… dd command: Native Linux tool, no installation needed
  • βœ… Ventoy: Multi-boot USB solution

πŸ“– Full Details: Known Incompatible Software


πŸš€ Quick Start

# Clone and install
git clone https://github.com/sprinteroz/Linux-NTFS-Manager.git
cd Linux-NTFS-Manager
./install.sh

# Or fix read-only NTFS drives directly
sudo ntfsfix /dev/sdX1  # Clears Windows hibernation flag

πŸ“₯ Download Latest Release | πŸ“– Read Testing Guide | πŸ› Report Issues


🎯 NTFS Support (Enhanced in v1.0.7)

Linux NTFS Manager provides intelligent NTFS mounting with advanced features for maximum compatibility and performance.

Automatic Driver Detection & Fallback

The application automatically detects and uses the best available NTFS driver:

  1. ntfs3 (Kernel 5.15+) - Best performance, 50-100% faster than FUSE
  2. lowntfs-3g - Reliable FUSE driver with enhanced error handling
  3. ntfs-3g - Universal fallback, works on all systems
  4. Read-only mount - Safe last resort for data access

You don't need to configure anything - the application chooses the optimal driver automatically.

Optimized Mount Options

Different drivers work best with different options. Linux NTFS Manager applies intelligent defaults:

For ntfs3 (Kernel Driver)

nofail,users,prealloc,windows_names,nocase
  • Performance optimized with file preallocation
  • Windows compatible with case-insensitive naming
  • User mountable without sudo

For ntfs-3g/lowntfs-3g (FUSE Drivers)

nofail,noexec,windows_names
  • Security focused with noexec protection
  • Windows compatible naming rules
  • Reliable with enhanced error handling

Dirty Volume Detection & Repair

Problem: Windows Fast Startup leaves NTFS drives in a "dirty" state that Linux refuses to mount.

Solution: Linux NTFS Manager v1.0.7+ includes an NTFS Repair Wizard that:

  • βœ… Detects dirty volumes automatically
  • βœ… Explains the problem clearly (Windows Fast Startup)
  • βœ… Provides ranked repair options (safest to riskiest)
  • βœ… Guides through Windows Fast Startup disable
  • βœ… Falls back to read-only if repair is declined

Access the Repair Wizard: Tools menu β†’ NTFS Repair Wizard

Performance Benefits

With ntfs3 driver (kernel 5.15+):

  • 50-100% faster file operations
  • Lower CPU usage
  • Better large file handling
  • Native kernel performance

Check your kernel version:

uname -r  # Need 5.15 or higher for ntfs3

Dual-Boot Best Practices

πŸ”΄ CRITICAL for Dual-Boot Users:

  1. Disable Windows Fast Startup (prevents 90% of mount issues)

    • Control Panel β†’ Power Options β†’ Choose what power buttons do
    • Uncheck "Turn on fast startup"
  2. Always shutdown Windows properly (not restart)

  3. Run CHKDSK periodically in Windows for filesystem health

  4. Let Linux NTFS Manager handle mounting automatically

Custom Configuration

Advanced users can customize mount options:

Create: ~/.config/ntfs-manager/mount-options.conf

[ntfs3]
options = nofail,users,prealloc,windows_names,nocase,big_writes

[ntfs-3g]
options = nofail,noexec,windows_names,compression

[lowntfs-3g]
options = nofail,noexec,windows_names

[fallback]
options = nofail

Comprehensive Documentation

For detailed NTFS information:

Quick Reference

Issue Solution Guide Link
"NTFS is marked dirty" Disable Windows Fast Startup Troubleshooting
Slow performance Use ntfs3 driver (kernel 5.15+) NTFS Guide
Driver not found Install ntfs-3g package Troubleshooting
Read-only mount Check Windows hibernation NTFS Guide
Permission errors Use Repair Wizard Troubleshooting

What's New in v1.0.7

  • ✨ Automatic driver detection with intelligent fallback
  • ⚑ Optimized mount options per driver type
  • πŸ”§ NTFS Repair Wizard with guided troubleshooting
  • πŸ“š Comprehensive documentation for all NTFS scenarios
  • 🎯 Windows Fast Startup detection and disable guide
  • πŸ›‘οΈ Read-only fallback for safe data access

πŸ’‘ Who This Is For

βœ… Dual-boot users tired of NTFS mounting issues
βœ… New Linux users who need clear explanations
βœ… System administrators managing multiple NTFS drives
βœ… Anyone who shares drives between Windows and Linux


✨ Features

Core Functionality

  • πŸ”„ Automatic NTFS Mounting: Internal NTFS drives auto-mount on startup with proper permissions
  • πŸ’Ώ ISO Burner: Burn ISO images to USB drives with progress tracking and verification
  • πŸ”Œ Hotplug Monitoring: Real-time udev monitoring for automatic drive detection and mounting
  • πŸ”₯ Hot-Swap Ready: Safely remove drives without data loss using udisksctl
  • Drive Management: Mount, unmount, and safely remove NTFS drives
  • Dirty Bit Detection: Identifies Windows hibernation issues automatically
  • Safe NTFS Repair: Uses ntfsfix to clear hibernation flags safely
  • One-Click Remounting: Automatically remounts after fixing
  • File Operations: Copy, move, delete files on NTFS partitions
  • Drive Information: View disk space, health status, and partition details
  • Format Options: Quick format with multiple filesystem options
  • GParted Integration: Advanced partitioning operations
  • Permission Management: Handle ownership and permission issues

User Interface

  • Modern GTK3 Interface: Clean, intuitive desktop application
  • Educational Dialogs: Explains WHY drives are read-only, not just HOW to fix
  • Command Line Tools: Full CLI support for automation and scripting
  • Nautilus Integration: Right-click context menu for file operations
  • System Tray: Quick access and status monitoring
  • Multi-Language Support: 32 languages with automatic detection

Enterprise Features

  • Audit Logging: Comprehensive operation tracking
  • Role-Based Access: User permission management
  • API Integration: Extensible for custom workflows
  • Performance Monitoring: Resource usage tracking
  • Security Scanning: Regular vulnerability assessments

🌍 Multi-Language Support

32 Languages Fully Supported: English, Spanish, French, German, Chinese, Japanese, Korean, Russian, Italian, Portuguese, Dutch, Polish, Turkish, Swedish, Norwegian, Danish, Finnish, Czech, Greek, Hebrew, Arabic, Hindi, Thai, Vietnamese, Indonesian, Malay, Hungarian, Romanian, Ukrainian, Bulgarian, Croatian, Serbian

Language Detection

  • Automatic: System locale detection
  • Manual: Language selection option
  • Fallback: English default for missing translations

Linux-NTFS-Manager: Hot-Swap Support & WinBoat Integration

Screencast.from.2025-11-05.11-21-32.webm

https://github.com/sprinteroz/Linux-NTFS-Manager/discussions


Breaking: Play Steam Games on NTFS Drives in Linux with Linux-NTFS-Manager

Screencast.from.2025-11-05.16-25-22.webm

πŸš€ Installation

Quick Install

# Clone the repository
git clone https://github.com/sprinteroz/Linux-NTFS-Manager.git
cd Linux-NTFS-Manager

# Run installation script
./install.sh

Requirements

  • Linux: Ubuntu 20.04+, Debian 11+, Fedora 35+, openSUSE Leap 15.4+
  • Memory: 4GB+ RAM recommended
  • Storage: 500MB available space
  • Permissions: sudo access for system integration

Package Managers

  • APT: sudo apt install ntfs-manager
  • DNF: sudo dnf install ntfs-manager
  • Pacman: sudo pacman -S ntfs-manager

πŸ“Š System Requirements

Minimum Requirements

  • OS: Linux (Kernel 5.15+)
  • Desktop: GNOME, KDE, XFCE, MATE, Cinnamon
  • Memory: 4GB RAM
  • Storage: 500MB free space
  • Python: 3.8+ (included with package)

Recommended Requirements

  • OS: Linux (Kernel 6.0+)
  • Memory: 8GB+ RAM
  • Storage: 2GB free space
  • Display: 1024x768 resolution

πŸ”§ Usage

GUI Application

# Launch from applications menu
ntfs-manager

# Or run from command line
ntfs-manager --help

Command Line

# List all drives
ntfs-manager --list

# Mount specific drive
ntfs-manager --mount /dev/sdb1

# Get drive information
ntfs-manager --info /dev/sdb1

# Unmount drive
ntfs-manager --unmount /dev/sdb1

πŸ“ Downloads

Stable Release

  • Version: v1.0.14
  • Release Date: November 12, 2025
  • Status: Production Ready

Download Options


πŸ› οΈ Troubleshooting

Common Issues

  • Permission Denied: Use sudo for system operations
  • Drive Not Found: Check device paths in /dev/
  • Mount Failed: Verify NTFS-3g is installed
  • GUI Not Starting: Check display environment variables

Getting Help


πŸ’¬ Community & Discussions

Join our growing community of Linux NTFS Manager users!

Note: Linux NTFS Manager is free for personal use. Commercial use requires a paid license - see LICENSE for details.


πŸ“ž Support

Professional Support

Reporting Issues

Please include:

  • System information (uname -a)
  • NTFS Manager version
  • Error messages
  • Steps to reproduce

πŸ”’ Security

Security Features

  • Permission Management: User access control
  • Audit Logging: Comprehensive operation tracking
  • Safe Operations: Verified hot-swap support
  • Regular Updates: Security patches and improvements
  • Code Review: Professional development practices

Privacy

  • No Telemetry: No data collection without consent
  • Local Processing: All operations performed locally
  • Open Source: Transparent and auditable codebase

πŸ“„ License

Dual License Model

This project uses a DUAL LICENSE system:

🏠 Personal Use - FREE

For home users, students, and personal projects

  • βœ… 100% FREE for personal, non-commercial use
  • βœ… Use at home for personal computing
  • βœ… Educational and learning purposes
  • βœ… Personal hobby projects
  • ❌ NOT for business or commercial use

πŸ’Ό Commercial Use - PAID LICENSE REQUIRED

Available in 6 months or once proven to be publiclly stable - in free version For businesses, companies, and organizations

  • ⚠️ Paid license required for any business use
  • πŸ’Ό Pricing: $99 - $2,999 USD/year (based on company size)
  • πŸ“§ Contact: [email protected] / [email protected]
  • πŸ†“ 30-day free trial available/ comming soon

License Files

Quick Guide

βœ… FREE if: Using at home, learning, personal projects
❌ PAID if: Using at work, in a business, or for profit

When in doubt, you need a commercial license.


🀝 Contributing

We welcome contributions from the community!

How to Contribute

Development

  • Code Style: Follow existing patterns
  • Testing: Include tests with contributions
  • Documentation: Update relevant sections

πŸ†οΈ Acknowledgments

Core Technologies

  • GTK+: Modern user interface framework
  • NTFS-3g: NTFS filesystem support
  • Python: Cross-platform compatibility
  • Linux: Native system integration

Community

Thanks to all users who have contributed to making NTFS Manager better through feedback, testing, and suggestions.


πŸ“ˆ Version History

Current Version: v1.0.14 (Stable)

Recent Updates

  • v1.0.14: Release v1.0.14 - Help Menu & About Dialog
  • v1.0.12: Help Menu & About Dialog
  • v1.0.11: Reliability - validation & tool detection (95% success rate)
  • v1.0.10: Performance - NTFS properties caching (80% faster)
  • v1.0.9: UX Improvements - spinners, tooltips, keyboard shortcuts
  • v1.0.8.2: Release v1.0.8.2 - Fix desktop launcher integration
  • v1.0.6: Release v1.0.6: Drive Details Enhancement
  • v1.0.3: Testing new stable release
  • v1.0.2: Security fixes and stability improvements
  • v1.0.1: System resource management tools
  • v1.0.0: Initial stable release

NTFS Manager - Professional NTFS Drive Management for Linux

Β© 2023-2025 MagDriveX - NTFS Manager Project. All rights reserved.

About

Professional NTFS Drive Management for Linux - Dual licensing with enterprise CI/CD pipeline

Resources

License

Unknown and 2 other licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE-COMMERCIAL
Unknown
LICENSE-PERSONAL

Security policy

Stars

Watchers

Forks

Packages

No packages published