Installation & Setup Guide

VetroLog is available as a free, pre-compiled standalone application for macOS, Windows, and Linux. No complex installation scripts or cloud logins are required.

---

⚡ Direct Download by Platform

Select your operating system below to start downloading immediately:

VS Code Extension

🧩 Official Visual Studio Code Extension

Install VetroLog directly inside Visual Studio Code from the Visual Studio Marketplace:

Install from Marketplace

Open in VS Code

Read Extension Guide

Marketplace Verified macOS · Windows · Linux v1.5.1

1-Click Install inside VS Code:

1. Press Ctrl+Shift+X (or Cmd+Shift+X on macOS) to open the Extensions panel.
2. Search for VetroLog.
3. Click Install.

CLI Install:

code --install-extension vetrolog.vetrolog

macOS

🍺 Method A: Homebrew Cask (Recommended)

Install VetroLog directly using the official tap:

brew install tanvirul-swe/tap/vetrolog

Or add the tap first and install:

brew tap tanvirul-swe/tap
brew install --cask vetrolog

---

📦 Method B: Direct DMG Download

Download macOS DMG (Universal)

Download .zip Archive

Apple Silicon (M1/M2/M3/M4) Intel Mac (x86_64) Universal 64-bit

1. Download the installer: Click the Download macOS DMG button above.
2. Mount the disk image: Double-click the downloaded VetroLog-macOS-Universal.dmg file.
3. Install to Applications: Drag the VetroLog.app icon into your Applications folder.
4. Launch VetroLog: Open VetroLog from your Applications folder, Launchpad, or Spotlight (Cmd + Space → VetroLog).

macOS Gatekeeper First-Launch Prompt

Because VetroLog is open-source and distributed directly without Apple’s paid Developer notarization program, macOS may display a Gatekeeper dialog (“VetroLog cannot be opened because the developer cannot be verified”).

To open with 1 click:

• Right-click (or Control-click) VetroLog.app in /Applications and select Open, then click Open in the dialog.
• Or run this command in your Terminal:

  xattr -d com.apple.quarantine /Applications/VetroLog.app

Windows

🪟 Method A: WinGet (Official Windows Package Manager)

Built into Windows 10 and Windows 11 by default:

winget install Hifzio.VetroLog

---

🍨 Method B: Scoop

Popular with command-line developers and power users:

scoop install https://raw.githubusercontent.com/Tanvirul-swe/vetrolog/main/distribution/scoop/vetrolog.json

---

📦 Method C: Portable Zero-Install ZIP

Download Portable ZIP (.zip)

1. Download VetroLog-Windows-x64-Portable.zip.
2. Extract the archive into any folder (e.g. C:\Tools\VetroLog).
3. Double-click vetrolog.exe to run immediately without admin privileges.

Linux

🛍️ Method A: Snap Store / Ubuntu App Center

Available on Ubuntu, Debian, Fedora, and openSUSE:

sudo snap install vetrolog

---

🏹 Method B: Arch User Repository (AUR)

For Arch Linux, Manjaro, and EndeavourOS:

yay -S vetrolog-bin

---

📦 Method C: Debian / Ubuntu Package (.deb)

Download Debian / Ubuntu (.deb)

Download Tarball (.tar.gz)

1. Download Package: Click Download Debian / Ubuntu (.deb) above.
2. Install via Terminal:

   sudo dpkg -i VetroLog-Linux-amd64.deb
   # If any dependencies are missing, auto-resolve with:
   sudo apt-get install -f

3. Launch: Open from your application drawer or run vetrolog in your terminal.

---

📦 Method D: Standalone Tarball (All Linux Distributions)

1. Download and extract VetroLog-Linux-x64.tar.gz:

   tar -xvf VetroLog-Linux-x64.tar.gz
   cd VetroLog-Linux-x64
   ./vetrolog

System Dependencies for Linux

VetroLog utilizes the native GTK3 and WebKit engine. Ensure your distribution has the runtime libraries:

• Debian / Ubuntu: sudo apt install libgtk-3-0 libwebkit2gtk-4.0-37 (or libwebkit2gtk-4.1-0)
• Fedora: sudo dnf install gtk3 webkit2gtk4.1
• Arch: sudo pacman -S gtk3 webkit2gtk-4.1

---

🌐 Headless Web Server Mode (Docker & Remote Machines)

If you are developing inside a headless Linux VM, remote server, or Docker container where no desktop display is available, VetroLog includes a built-in headless web server mode:

# Launch VetroLog as a local web server (default: http://localhost:8787)
./vetrolog --web

# Or specify a custom port
./vetrolog --web --port 9090

# Or prevent auto-opening the browser on startup
./vetrolog --web --no-browser

Simply open http://localhost:8787 in your favorite browser (Google Chrome, Safari, Firefox, Edge).

---

🛠️ Building from Source

If you want to contribute or build VetroLog from the source code:

Prerequisites

• Go 1.22+: golang.org
• Node.js 20+ & npm: nodejs.org
• Wails v2 CLI:

  go install github.com/wailsapp/wails/v2/cmd/wails@latest

Build Instructions

# 1. Clone the repository
git clone https://github.com/Tanvirul-swe/vetrolog.git
cd vetrolog

# 2. Install frontend dependencies
cd frontend && npm install && cd ..

# 3. Run in live hot-reload development mode
wails dev

# 4. Or compile a production release binary
wails build

The compiled native executable will be located in the build/bin/ folder.

---

🚀 Next Steps

Once VetroLog is installed and open:

• Follow the 3-Minute Quickstart Tutorial to inspect your first database.
• Learn about Automatic ADB Discovery for connected phones and emulators.