About

Fast and lightweight command-line interface for DuckDuckGo search. Built with Go and Bubble Tea for a smooth terminal experience, have sdk - see Links.

Fast Start

Install

Fast Install (Linux/macOS):

curl -fsSL https://raw.githubusercontent.com/zarazaex69/zuk/refs/heads/master/install.sh | bash

Usage

# Start ZUK
zuk

# Duckle with zuk 
zuk text

# Set theme
zuk -t nya
zuk --theme soft

# List available themes
zuk --list-themes

Keyboard Shortcuts

• Type - Enter search query
• Enter - Execute search / Open selected result in browser
• ↑/↓ or j/k - Navigate through results
• Backspace - Return to search input
• Esc or q - Quit application

Theme preference is saved in ~/.config/zuk/config.json

How It Works

ZUK uses DuckDuckGo's Lite interface to perform searches:

1. Sends POST request to https://lite.duckduckgo.com/lite/
2. Parses HTML response using goquery
3. Extracts search results (title, URL, snippet)
4. Renders in viewport with theme-based styling
5. Tracks cursor position with auto-scrolling
6. Opens selected URLs in default browser

---

Contact

Telegram: zarazaex
Email: zarazaex@tuta.io
Site: zarazaex.xyz