pdflinux 0.1.0 → 0.1.2

package/README.md

@@ -1,102 +1,159 @@
 # PDFLinux
 
-> **100% Gratis. Tanpa langganan. Tanpa akun. File kamu tidak pernah meninggalkan komputermu.**
+[![npm version](https://img.shields.io/npm/v/pdflinux.svg)](https://www.npmjs.com/package/pdflinux)
+[![npm downloads](https://img.shields.io/npm/dm/pdflinux.svg)](https://www.npmjs.com/package/pdflinux)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)](#install)
 
-Aplikasi desktop untuk semua kebutuhan PDF sehari-hari. Dibangun dengan Tauri + Rust di backend dan React + TypeScript di frontend — berjalan 100% di mesin lokal, tanpa koneksi internet, tanpa upload ke mana pun.
+> **100% free. No subscription. No account. Your files never leave your computer.**
+
+A fast, privacy-first desktop application for all your everyday PDF tasks. Built with Tauri + Rust on the backend and React + TypeScript on the frontend — runs entirely on your local machine, no internet connection required, no files uploaded anywhere.
 
 ---
 
-## Install
+## Table of Contents
 
-### Cara 1 — Git Clone (direkomendasikan)
+- [Quick Install](#quick-install)
+- [Why PDFLinux?](#why-pdflinux)
+- [Features](#features)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Tech Stack](#tech-stack)
+- [Development](#development)
+- [Project Structure](#project-structure)
+- [Contributing](#contributing)
+- [License](#license)
+- [Privacy](#privacy)
 
-```bash
-git clone https://github.com/saaandbite/pdflinux.git
-cd pdflinux
-./install.sh
-```
+---
 
-Script `install.sh` akan otomatis:
-- Mendeteksi distro kamu (Debian/Ubuntu, Fedora/RHEL/CentOS, Arch, dll.)
-- Menginstal semua dependensi yang dibutuhkan
-- Membangun aplikasi
-- Menginstal paket `.deb` / `.rpm` / `AppImage` sesuai distro
-- Menambahkan shortcut di menu aplikasi dan command `pdflinux` di terminal
+## Quick Install
 
-Untuk uninstall:
 ```bash
-./uninstall.sh
+npx pdflinux
 ```
 
-### Cara 2 — npx (via npm)
+That's it. The installer detects your distro, installs all dependencies, builds the app, and adds it to your application menu.
+
+---
+
+## Why PDFLinux?
+
+Most online PDF tools require you to upload your files to their servers. For sensitive documents — contracts, medical records, IDs — that's a real risk. PDFLinux processes everything **on your machine**, with no internet connection and no uploads anywhere.
+
+- **Free forever** — no freemium, no trial, no subscription
+- **Privacy-first** — zero network requests, zero telemetry
+- **Lightweight** — powered by Tauri (uses the OS native webview, not a bundled Chromium like Electron)
+- **Linux-first** — primary target is Linux; Windows and macOS are also supported via Tauri
+- **Open source** — auditable, forkable, yours
+
+---
+
+## Features
+
+17 PDF tools, all running locally on your machine:
+
+| Tool | Description |
+|---|---|
+| **Compress** | Reduce PDF file size using Ghostscript with quality presets |
+| **Merge** | Combine multiple PDFs into one, with drag-to-reorder support |
+| **Split** | Extract a range of pages (e.g. `1-5, 8, 11-15`) into separate files |
+| **PDF to Image** | Export every page to PNG or JPG via Poppler |
+| **Image to PDF** | Bundle one or more images into a single PDF |
+| **Protect** | Encrypt a PDF with a password (QPDF) |
+| **Unlock** | Remove password protection from a PDF |
+| **Rotate** | Rotate pages by 90°, 180°, or 270° |
+| **Watermark** | Stamp text or image watermarks on pages |
+| **Crop** | Trim page margins to a custom crop box |
+| **Delete Pages** | Remove specific pages from a document |
+| **Reorder Pages** | Drag and drop pages into a new order |
+| **Add Page Numbers** | Stamp page numbers onto every page |
+| **PDF to Text** | Extract plain text content from a PDF |
+| **Grayscale** | Convert a color PDF to black and white |
+| **OCR** | Run optical character recognition on scanned pages |
+| **PDF Info** | Inspect metadata: page count, dimensions, title, author |
+
+---
+
+## Prerequisites
+
+PDFLinux requires a few native CLI utilities to do the heavy lifting. The installer will install these for you automatically, but here is the list for reference:
 
-Jika kamu sudah punya Node.js terinstal:
+- **Ghostscript** — for compression and color operations
+- **Poppler** — for PDF-to-image conversion and text extraction
+- **QPDF** — for encryption, decryption, and page operations
+- **Tesseract** — for OCR
+
+The installer also requires:
+- A supported Linux distro (Debian, Ubuntu, Fedora, RHEL, CentOS, Arch, openSUSE, or derivatives)
+- `sudo` privileges (to install system packages)
+- Internet access (during installation only)
+
+---
+
+## Installation
+
+### Option 1 — npx (easiest)
+
+If you already have Node.js installed:
 
 ```bash
 npx pdflinux
 ```
 
-Untuk uninstall:
+To uninstall:
 ```bash
 npx pdflinux uninstall
 ```
 
----
+### Option 2 — Git Clone
 
-## Kenapa PDFLinux?
+```bash
+git clone https://github.com/saaandbite/pdflinux.git
+cd pdflinux
+./install.sh
+```
 
-Sebagian besar alat PDF online mengharuskan kamu mengupload file ke server mereka. Untuk dokumen sensitif — kontrak, catatan medis, KTP — itu risiko nyata. PDFLinux memproses semuanya **di mesin kamu**, tanpa koneksi internet, tanpa upload ke mana pun.
+The `install.sh` script will automatically:
+- Detect your distro (Debian/Ubuntu, Fedora/RHEL/CentOS, Arch, etc.)
+- Install all required dependencies
+- Build the application
+- Install the appropriate package (`.deb` / `.rpm` / `AppImage`) for your distro
+- Add a shortcut to your app menu and a `pdflinux` command in the terminal
 
-- **Gratis selamanya** — tidak ada freemium, tidak ada trial, tidak ada langganan
-- **Privacy-first** — zero network requests, zero telemetry
-- **Ringan** — ditenagai Tauri (native webview OS, bukan Chromium bundled seperti Electron)
-- **Linux-first** — target utama Linux; Windows dan macOS didukung via Tauri
+To uninstall:
+```bash
+./uninstall.sh
+```
 
----
+### Launching the app
 
-## Fitur
+After installation you can launch PDFLinux in two ways:
 
-| Alat | Deskripsi |
-|---|---|
-| **Compress** | Perkecil ukuran file PDF dengan Ghostscript |
-| **Merge** | Gabungkan beberapa PDF menjadi satu |
-| **Split** | Ekstrak halaman tertentu (misal `1-5, 8, 11-15`) |
-| **PDF to Image** | Ekspor setiap halaman ke PNG atau JPG via Poppler |
-| **Image to PDF** | Bundel satu atau lebih gambar menjadi PDF |
-| **Protect** | Enkripsi PDF dengan kata sandi (QPDF) |
-| **Unlock** | Hapus proteksi kata sandi dari PDF |
-| **Rotate** | Putar halaman 90°, 180°, atau 270° |
-| **Watermark** | Tambahkan watermark teks atau gambar pada halaman |
-| **Crop** | Pangkas margin halaman ke crop box kustom |
-| **Delete Pages** | Hapus halaman tertentu dari dokumen |
-| **Reorder Pages** | Drag and drop halaman ke urutan baru |
-| **Add Page Numbers** | Tambahkan nomor halaman ke setiap halaman |
-| **PDF to Text** | Ekstrak konten teks dari PDF |
-| **Grayscale** | Konversi PDF berwarna ke hitam putih |
-| **OCR** | Jalankan optical character recognition pada halaman scan |
-| **PDF Info** | Lihat metadata: jumlah halaman, dimensi, judul, penulis |
+- **Application menu** — search for "PDFLinux" in your desktop environment's app launcher
+- **Terminal** — run `pdflinux` from anywhere
 
 ---
 
 ## Tech Stack
 
-| Layer | Teknologi |
+| Layer | Technology |
 |---|---|
 | Desktop shell | [Tauri 2](https://tauri.app/) |
 | Backend / PDF engine | Rust + Ghostscript + Poppler + QPDF |
 | Frontend | React 19, TypeScript, Vite |
 | Routing | React Router 7 |
-| Styling | Vanilla CSS dengan dark/light mode |
+| Styling | Vanilla CSS with dark/light mode |
 
-### Kenapa Tauri bukan Electron?
+### Why Tauri instead of Electron?
 
-Tauri menggunakan native webview OS (WebKitGTK di Linux) alih-alih membundel Chromium penuh. Hasilnya binary yang **10–20× lebih kecil** dan menggunakan sebagian kecil RAM dibanding aplikasi Electron setara.
+Tauri uses the operating system's native webview (WebKitGTK on Linux) instead of bundling a full Chromium engine. The result is a binary that is **10–20× smaller** and uses a fraction of the RAM compared to equivalent Electron apps.
 
 ---
 
 ## Development
 
-Jika ingin menjalankan dari source untuk development:
+To run from source for local development:
 
 ```bash
 git clone https://github.com/saaandbite/pdflinux.git
@@ -105,61 +162,65 @@ npm install
 npm run tauri dev
 ```
 
-Build production:
+To build a production binary:
 
 ```bash
 npm run tauri build
 ```
 
-Output installer ada di `src-tauri/target/release/bundle/`:
+Output installers are placed in `src-tauri/target/release/bundle/`:
 
 | Format | Distro |
 |---|---|
-| `.deb` | Debian / Ubuntu dan turunannya |
-| `.rpm` | Fedora / RHEL / CentOS dan turunannya |
-| `.AppImage` | Semua distro Linux (portable) |
+| `.deb` | Debian / Ubuntu and derivatives |
+| `.rpm` | Fedora / RHEL / CentOS and derivatives |
+| `.AppImage` | Any Linux distro (portable) |
 
 ---
 
-## Struktur Proyek
+## Project Structure
 
 ```
 pdflinux/
 ├── src/                        # React frontend (TypeScript)
-│   ├── components/             # Komponen UI (Sidebar, Dropzone, dll.)
-│   ├── pages/                  # Satu file per alat PDF
-│   ├── App.tsx                 # Definisi route
-│   └── main.tsx                # Entry point React
+│   ├── components/             # Shared UI components (Sidebar, Dropzone, etc.)
+│   ├── pages/                  # One file per PDF tool
+│   ├── App.tsx                 # Route definitions
+│   └── main.tsx                # React entry point
+│
+├── src-tauri/                  # Rust backend (Tauri)
+│   ├── src/
+│   │   ├── main.rs             # Tauri entry point
+│   │   └── pdf_engine.rs       # PDF processing logic (calls gs, qpdf, poppler)
+│   ├── tauri.conf.json         # App window and build configuration
+│   └── Cargo.toml              # Rust dependencies
 │
-└── src-tauri/                  # Rust backend (Tauri)
-    ├── src/
-    │   ├── main.rs             # Entry point Tauri
-    │   └── pdf_engine.rs       # Logic pemrosesan PDF (memanggil gs, qpdf, poppler)
-    ├── tauri.conf.json         # Konfigurasi window dan build
-    └── Cargo.toml              # Dependensi Rust
+├── bin/pdflinux                # npm CLI wrapper
+├── install.sh                  # Linux installer script
+└── uninstall.sh                # Linux uninstaller script
 ```
 
 ---
 
-## Kontribusi
+## Contributing
 
-Kontribusi sangat disambut. Jika menemukan bug atau ingin menambahkan fitur:
+Contributions are welcome. If you find a bug or want to add a feature:
 
-1. Fork repository ini
-2. Buat branch: `git checkout -b feature/nama-fitur-kamu`
-3. Commit perubahan: `git commit -m "feat: deskripsi perubahan"`
-4. Push dan buka Pull Request
+1. Fork the repository
+2. Create a branch: `git checkout -b feature/your-feature-name`
+3. Commit your changes: `git commit -m "feat: describe your change"`
+4. Push and open a Pull Request
 
-Buka issue terlebih dahulu untuk perubahan besar agar bisa diskusi dulu.
+Please open an issue first for larger changes so we can discuss the approach.
 
 ---
 
-## Lisensi
+## License
 
-Proyek ini open source. Lihat [LICENSE](./LICENSE) untuk detail.
+This project is open source under the [MIT License](./LICENSE).
 
 ---
 
-## Privasi
+## Privacy
 
-PDFLinux tidak mengumpulkan data apa pun. Tidak ada network request. Semua pemrosesan terjadi secara lokal menggunakan CLI tool yang terinstal di sistemmu (Ghostscript, Poppler, QPDF, Tesseract). Dokumenmu tidak pernah diupload, dicatat, atau dibagikan ke mana pun.
+PDFLinux does not collect any data. It makes no network requests. All processing happens locally using the CLI tools installed on your system (Ghostscript, Poppler, QPDF, Tesseract). Your documents are never uploaded, logged, or shared anywhere.

package/bin/pdflinux

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
-'use strict';
+import { spawnSync } from 'node:child_process';
+import { resolve, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
 
-const { execFileSync, spawnSync } = require('child_process');
-const { resolve, dirname } = require('path');
-const { existsSync } = require('fs');
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
 const root = resolve(__dirname, '..');
 const installScript = resolve(root, 'install.sh');
@@ -14,7 +16,7 @@ const cmd = args[0];
 
 if (cmd === 'uninstall') {
     if (!existsSync(uninstallScript)) {
-        console.error('uninstall.sh tidak ditemukan.');
+        console.error('uninstall.sh not found.');
         process.exit(1);
     }
     const result = spawnSync('bash', [uninstallScript], { stdio: 'inherit' });
@@ -23,7 +25,7 @@ if (cmd === 'uninstall') {
 
 // Default: install
 if (!existsSync(installScript)) {
-    console.error('install.sh tidak ditemukan.');
+    console.error('install.sh not found.');
     process.exit(1);
 }
 

package/install.sh

@@ -39,7 +39,7 @@ detect_pkg_manager() {
 
 install_system_deps() {
     local pm="$1"
-    info "Menginstal dependensi sistem PDF (Ghostscript, Poppler, QPDF, Tesseract)..."
+    info "Installing PDF system dependencies (Ghostscript, Poppler, QPDF, Tesseract)..."
 
     case "$pm" in
         apt)
@@ -73,7 +73,7 @@ install_system_deps() {
                 pkg-config gcc curl wget
             ;;
         *)
-            warn "Package manager tidak dikenali. Pastikan dependensi berikut sudah terinstal:"
+            warn "Package manager not recognized. Make sure these are installed:"
             warn "  ghostscript, poppler-utils, qpdf, tesseract-ocr"
             ;;
     esac
@@ -81,21 +81,21 @@ install_system_deps() {
 
 install_rust() {
     if command -v rustup &>/dev/null && rustup show active-toolchain &>/dev/null; then
-        success "Rust sudah terinstal: $(rustc --version)"
+        success "Rust already installed: $(rustc --version)"
         return
     fi
-    info "Menginstal Rust via rustup..."
+    info "Installing Rust via rustup..."
     curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y --no-modify-path
     export PATH="$HOME/.cargo/bin:$PATH"
-    success "Rust terinstal: $(rustc --version)"
+    success "Rust installed: $(rustc --version)"
 }
 
 install_node() {
     if command -v node &>/dev/null; then
-        success "Node.js sudah terinstal: $(node --version)"
+        success "Node.js already installed: $(node --version)"
         return
     fi
-    info "Menginstal Node.js via NodeSource..."
+    info "Installing Node.js via NodeSource..."
     local pm="$1"
     case "$pm" in
         apt)
@@ -113,21 +113,21 @@ install_node() {
             sudo zypper install -y nodejs npm
             ;;
         *)
-            error "Silakan install Node.js LTS secara manual dari https://nodejs.org/ lalu jalankan ulang script ini."
+            error "Please install Node.js LTS manually from https://nodejs.org/ then run this script again."
             ;;
     esac
-    success "Node.js terinstal: $(node --version)"
+    success "Node.js installed: $(node --version)"
 }
 
 build_app() {
-    info "Menginstal dependensi npm..."
+    info "Installing npm dependencies..."
     npm ci --silent
 
-    info "Membangun aplikasi (ini mungkin butuh beberapa menit pertama kali)..."
+    info "Building application (this may take a few minutes the first time)..."
     export PATH="$HOME/.cargo/bin:$PATH"
     npm run tauri build
 
-    success "Build selesai."
+    success "Build complete."
 }
 
 install_package() {
@@ -139,9 +139,9 @@ install_package() {
             local deb
             deb=$(find "$bundle_dir/deb" -name "*.deb" 2>/dev/null | head -1)
             if [ -n "$deb" ]; then
-                info "Menginstal paket .deb: $deb"
+                info "Installing .deb package: $deb"
                 sudo dpkg -i "$deb"
-                success "$DISPLAY_NAME berhasil diinstal."
+                success "$DISPLAY_NAME installed successfully."
                 return
             fi
             ;;
@@ -149,9 +149,9 @@ install_package() {
             local rpm
             rpm=$(find "$bundle_dir/rpm" -name "*.rpm" 2>/dev/null | head -1)
             if [ -n "$rpm" ]; then
-                info "Menginstal paket .rpm: $rpm"
+                info "Installing .rpm package: $rpm"
                 sudo "$pm" install -y "$rpm"
-                success "$DISPLAY_NAME berhasil diinstal."
+                success "$DISPLAY_NAME installed successfully."
                 return
             fi
             ;;
@@ -159,17 +159,17 @@ install_package() {
             ;;
     esac
 
-    # Fallback ke AppImage
+    # Fallback to AppImage
     local appimage
     appimage=$(find "$bundle_dir/appimage" -name "*.AppImage" 2>/dev/null | head -1)
     if [ -n "$appimage" ]; then
-        info "Menginstal AppImage..."
+        info "Installing AppImage..."
         local install_dir="$HOME/.local/bin"
         mkdir -p "$install_dir"
         cp "$appimage" "$install_dir/$APP_NAME"
         chmod +x "$install_dir/$APP_NAME"
 
-        # Tambahkan ke PATH jika belum ada
+        # Add to PATH if not already there
         local shell_rc=""
         case "$SHELL" in
             */bash) shell_rc="$HOME/.bashrc" ;;
@@ -178,15 +178,15 @@ install_package() {
         esac
         if [ -n "$shell_rc" ] && ! grep -q "$install_dir" "$shell_rc" 2>/dev/null; then
             echo "export PATH=\"$install_dir:\$PATH\"" >> "$shell_rc"
-            warn "PATH diperbarui di $shell_rc. Jalankan: source $shell_rc"
+            warn "PATH updated in $shell_rc. Run: source $shell_rc"
         fi
 
         install_desktop_file "$appimage"
-        success "$DISPLAY_NAME berhasil diinstal sebagai AppImage."
+        success "$DISPLAY_NAME installed as AppImage."
         return
     fi
 
-    error "Tidak ada installer yang ditemukan di $bundle_dir"
+    error "No installer found in $bundle_dir"
 }
 
 install_desktop_file() {
@@ -205,7 +205,7 @@ install_desktop_file() {
 [Desktop Entry]
 Type=Application
 Name=PDFLinux
-Comment=Privacy-first PDF tools untuk Linux — berjalan 100% offline
+Comment=Privacy-first PDF tools for Linux — runs 100% offline
 Exec=$exec_path
 Icon=$APP_NAME
 Categories=Office;Utility;
@@ -219,7 +219,7 @@ EOF
     if command -v gtk-update-icon-cache &>/dev/null; then
         gtk-update-icon-cache -f "$HOME/.local/share/icons/hicolor" &>/dev/null || true
     fi
-    success "Shortcut menu aplikasi ditambahkan."
+    success "Application menu shortcut added."
 }
 
 # ── Main ────────────────────────────────────────────────────────────────────
@@ -236,7 +236,7 @@ cd "$SCRIPT_DIR"
 DISTRO=$(detect_distro)
 PKG_MANAGER=$(detect_pkg_manager)
 
-info "Distro terdeteksi: $DISTRO (package manager: $PKG_MANAGER)"
+info "Detected distro: $DISTRO (package manager: $PKG_MANAGER)"
 
 install_system_deps "$PKG_MANAGER"
 install_rust
@@ -246,9 +246,9 @@ install_package "$PKG_MANAGER"
 
 echo ""
 echo -e "${GREEN}╔══════════════════════════════════════════════════════╗${NC}"
-echo -e "${GREEN}║   ✓ PDFLinux berhasil diinstal!                      ║${NC}"
+echo -e "${GREEN}║   ✓ PDFLinux installed successfully!                 ║${NC}"
 echo -e "${GREEN}║                                                      ║${NC}"
-echo -e "${GREEN}║   • Buka dari menu aplikasi: cari \"PDFLinux\"         ║${NC}"
-echo -e "${GREEN}║   • Atau jalankan via terminal: pdflinux              ║${NC}"
+echo -e "${GREEN}║   • Launch from app menu: search for \"PDFLinux\"      ║${NC}"
+echo -e "${GREEN}║   • Or run from terminal: pdflinux                   ║${NC}"
 echo -e "${GREEN}╚══════════════════════════════════════════════════════╝${NC}"
 echo ""

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pdflinux",
-  "version": "0.1.0",
-  "description": "Privacy-first PDF tools untuk Linux — berjalan 100% offline",
+  "version": "0.1.2",
+  "description": "Privacy-first PDF tools for Linux — runs 100% offline",
   "keywords": ["pdf", "linux", "tools", "privacy", "tauri", "desktop"],
   "author": "saaandbite",
   "license": "MIT",

package/uninstall.sh

@@ -11,7 +11,6 @@ NC='\033[0m'
 
 info()    { echo -e "${BLUE}[*]${NC} $*"; }
 success() { echo -e "${GREEN}[✓]${NC} $*"; }
-error()   { echo -e "${RED}[✗]${NC} $*"; exit 1; }
 
 detect_pkg_manager() {
     if command -v apt &>/dev/null; then echo "apt"
@@ -30,30 +29,30 @@ echo -e "${RED}║   PDFLinux — Uninstall           ║${NC}"
 echo -e "${RED}╚══════════════════════════════════╝${NC}"
 echo ""
 
-# Hapus paket yang diinstal via package manager
+# Remove package installed via package manager
 case "$PM" in
     apt)
-        if dpkg -l "pdf-tools" &>/dev/null 2>&1; then
-            info "Menghapus paket .deb..."
-            sudo apt-get remove -y pdf-tools || true
+        if dpkg -l "pdflinux" &>/dev/null 2>&1; then
+            info "Removing .deb package..."
+            sudo apt-get remove -y pdflinux || true
         fi
         ;;
     dnf|yum)
-        if rpm -q "pdf-tools" &>/dev/null 2>&1; then
-            info "Menghapus paket .rpm..."
-            sudo "$PM" remove -y pdf-tools || true
+        if rpm -q "pdflinux" &>/dev/null 2>&1; then
+            info "Removing .rpm package..."
+            sudo "$PM" remove -y pdflinux || true
         fi
         ;;
 esac
 
-# Hapus AppImage
+# Remove AppImage
 if [ -f "$HOME/.local/bin/$APP_NAME" ]; then
-    info "Menghapus AppImage..."
+    info "Removing AppImage..."
     rm -f "$HOME/.local/bin/$APP_NAME"
 fi
 
-# Hapus .desktop file dan ikon
-info "Menghapus shortcut menu aplikasi..."
+# Remove .desktop file and icon
+info "Removing application menu shortcut..."
 rm -f "$HOME/.local/share/applications/$APP_NAME.desktop"
 rm -f "$HOME/.local/share/icons/hicolor/128x128/apps/$APP_NAME.png"
 
@@ -61,5 +60,5 @@ if command -v update-desktop-database &>/dev/null; then
     update-desktop-database "$HOME/.local/share/applications" &>/dev/null || true
 fi
 
-success "$DISPLAY_NAME berhasil dihapus."
+success "$DISPLAY_NAME removed successfully."
 echo ""