Skip to content

Latest commit

 

History

History
108 lines (86 loc) · 3.36 KB

installation.md

File metadata and controls

108 lines (86 loc) · 3.36 KB

Installation Guide

Nextcloud Upload Tool (nut) is available as a standalone command-line tool and a desktop GUI application across macOS, Windows, and Linux.


1. Package Managers

macOS & Linux (Homebrew)

# Install CLI (`nut`) + shell completions:
brew install headhunter45/tap/nut

# Install macOS Desktop GUI (`Nextcloud Upload Tool.app`):
brew install --cask headhunter45/tap/nextcloud-upload-tool

Windows (Winget & Chocolatey)

# Windows Package Manager (Winget):
winget install headhunter45.NextcloudUploadTool

# Chocolatey:
choco install nextcloud-upload-tool

Arch Linux (AUR)

# Using an AUR helper (paru / yay):
yay -S nextcloud-upload-tool-bin

(Manifest definitions are maintained in packaging/.)


2. Pre-built Binaries & Installers

Download pre-built releases for your operating system from the Releases page.

macOS (Apple Silicon & Intel)

  • GUI Desktop App: Download the .dmg installer, open it, and drag Nextcloud Upload Tool.app into /Applications.
  • CLI Binary:
    # Apple Silicon (M1/M2/M3/M4)
    curl -fsSL https://github.com/majinnaibu/nextcloud-upload-tool/releases/latest/download/nut-aarch64-apple-darwin.tar.gz | tar -xz
    sudo mv nut /usr/local/bin/
    
    # Intel x86_64
    curl -fsSL https://github.com/majinnaibu/nextcloud-upload-tool/releases/latest/download/nut-x86_64-apple-darwin.tar.gz | tar -xz
    sudo mv nut /usr/local/bin/

Linux (Debian, Ubuntu, Fedora, Arch, Generic)

  • Debian / Ubuntu (.deb):
    sudo dpkg -i nextcloud-upload-tool_0.1.0_amd64.deb
    sudo apt-get install -f
  • Fedora / RHEL (.rpm):
    sudo rpm -i nextcloud-upload-tool-0.1.0-1.x86_64.rpm
  • Universal AppImage:
    chmod +x Nextcloud_Upload_Tool_0.1.0_amd64.AppImage
    ./Nextcloud_Upload_Tool_0.1.0_amd64.AppImage
  • Static CLI Binary (musl libc - zero external dependencies):
    curl -fsSL https://github.com/majinnaibu/nextcloud-upload-tool/releases/latest/download/nut-x86_64-unknown-linux-musl.tar.gz | tar -xz
    sudo mv nut /usr/local/bin/

Windows

  • GUI Installer (.msi / NSIS .exe): Download and run Nextcloud-Upload-Tool-Setup.exe or Nextcloud-Upload-Tool.msi. Follow the installer wizard.
  • Standalone CLI: Download nut-x86_64-pc-windows-msvc.zip, extract nut.exe, and add it to your system %PATH%.

3. Building from Source

Prerequisites

  • Rust toolchain (1.75+): Install via curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Node.js (v20, pinned in .nvmrc) and Yarn Berry (corepack enable)
  • Platform Development Libraries:
    • Linux: sudo apt-get install libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libssl-dev libdbus-1-dev pkg-config patchelf
    • macOS: Xcode Command Line Tools (xcode-select --install)
    • Windows: Visual Studio C++ Build Tools

Build the CLI (nut)

git clone https://github.com/headhunter45/NextcloudUploadTool.git
cd NextcloudUploadTool

cargo build --release -p nut
# The binary is placed at target/release/nut

Build the Desktop GUI

cd gui
corepack enable
yarn install
yarn build
yarn tauri build
# The packaged bundle is located in gui/src-tauri/target/release/bundle/