gitdrive-install
v1.0.2
Published
Desktop application turning GitHub repositories into a personal cloud drive
Maintainers
Readme
Why GitDrive?
Managing personal files across the cloud has two major pain points:
- Commercial cloud storage is expensive and vendor-locked. Monthly subscriptions for Google Drive, Dropbox, and OneDrive add up every year, while your personal files and documents are stored on third-party servers.
- Git and GitHub offer free, infinite versioned storage, but git CLI is too tedious for daily file management. Opening a terminal to run git commands every time you want to save a PDF, presentation, screenshot, or design asset is high-friction.
GitDrive bridges this gap. It gives you the familiar, beautiful desktop experience of a modern cloud drive, backed 100% by your own GitHub account:
- Zero subscription fees: Unlimited repositories and storage backed directly by GitHub.
- True data ownership: Your files live in your own repositories with no middleman servers.
- Native OS Drag and Drop: Drag documents, PDFs, and media directly from GitDrive out onto your Desktop, Finder, or Windows File Explorer.
- Built-in Time Machine: Effortlessly inspect and restore past versions of any file backed by Git commit history.
Overview
GitDrive is an open-source cross-platform desktop application that transforms your GitHub repositories into personal cloud storage. It pairs the familiar graphical experience of a native desktop drive with the durability, zero infrastructure cost, and version control of GitHub. With native drag-and-drop file transfers, client-side encryption, and seamless file management, GitDrive offers a private, subscription-free alternative to traditional commercial cloud providers.
Get Started
Install and launch GitDrive using any of the options below:
Option 1: Instant 1-Line Install via NPX (Recommended)
If you have Node.js installed, run this single command in your terminal:
npx gitdrive-installAutomatically detects your OS (macOS Apple Silicon/Intel or Windows), downloads the latest desktop build, installs it into your applications folder, and launches the app.
Option 2: 1-Line Terminal Scripts (No Node.js Required)
macOS (Terminal):
curl -fsSL https://raw.githubusercontent.com/theabhishekarmagi/GitDesk/main/install.sh | bashWindows (PowerShell):
irm https://raw.githubusercontent.com/theabhishekarmagi/GitDesk/main/install.ps1 | iexOption 3: Homebrew Cask (macOS)
brew install --cask theabhishekarmagi/tap/gitdriveUpdate anytime with:
brew upgrade gitdriveOption 4: Manual Desktop Downloads
Pre-built self-contained desktop binaries are compiled on every release:
- macOS (Apple Silicon M1/M2/M3/M4): Download
.dmgor Download.zip - macOS (Intel): Download
.dmgor Download.zip - Windows (x64): Download Setup
.exeor Download Portable.zip
[!NOTE] On macOS, move
GitDrive.appto Applications. The first time you launch, if macOS Gatekeeper displays a verification prompt, simply right-click and choose Open, or runxattr -cr /Applications/GitDrive.app.
Option 5: Developer Setup (Build from Source)
Clone the repository and start the development environment:
# 1. Clone repository
git clone https://github.com/theabhishekarmagi/GitDesk.git
cd GitDesk
# 2. Install dependencies
npm install
# 3. Start development environment
npm run devBuild production executables locally:
# Build for macOS
npm run dist:mac
# Build for Windows
npm run dist:winSecurity & Privacy
- Direct API Communication: GitDrive communicates directly with the official GitHub REST API (
api.github.com). No intermediate proxy or relay server is used. - Hardware Keychain Storage: Your GitHub Personal Access Token is stored using Electron's
safeStorageAPI, which leverages Apple Keychain on macOS and Windows DPAPI on Windows. - Dual-Layer Auto-Login: Sessions are persistent across updates and app restarts. Tokens are destroyed only when you explicitly click Log out.
Contributing
Contributions, issues, and feature requests are welcome. Feel free to check the issues page.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'feat: Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
Distributed under the MIT License. See LICENSE for more information.
