বিষয়বস্তুতে যান
গিটহাব · সিঙ্ক করা
সমস্ত প্রকল্প

সহায়ক স্ক্রিপ্ট TUI

Proxmox কমিউনিটি হেল্পার স্ক্রিপ্টগুলো অনুসন্ধান, পরীক্ষা এবং ইনস্টল করার জন্য একটি টার্মিনাল ইউজার ইন্টারফেস।

এই নিবন্ধটি ইংরেজি থেকে যন্ত্রের সাহায্যে অনুবাদ করা হয়েছে। মূলটি পড়ুন

কমিট
21
গত বছর
তারকারা
1
ভাষা
Go
শেষ ধাক্কা
মার্চ 2026
MIT License
এই পৃষ্ঠায়
  1. এটা কি
  2. স্ট্যাক
  3. কঠিন অংশ
  4. অবস্থা
  5. README

এটা কি#

Proxmox ভিই কমিউনিটি হেল্পার স্ক্রিপ্টগুলোর জন্য একটি টার্মিনাল ইউআই; এই এক-লাইনের ইনস্টলারগুলো বেশিরভাগ homelab কন্টেইনার এবং ভিএম সেট আপ করে। ওয়েবসাইট ব্রাউজ করে শেলে curl | bash পেস্ট করার পরিবর্তে, আপনি নোডে hst চালান । সেখান থেকে আপনি ক্যাটালগটি ফাজি-সার্চ করেন, একটি স্ক্রিপ্টের রিসোর্স, নোট এবং ডিফল্টগুলো পড়েন, একটি ভ্যারিয়েন্ট বেছে নেন, নিশ্চিত করেন এবং এটি রান হয়ে যায়।

স্ট্যাক#

বাবল টি, বাবলস এবং লিপ গ্লস বেছে নিন। ক্যাটাগরিগুলো (কন্টেইনার, ভিএম, বিবিধ) আপস্ট্রিম রিপোজিটরির লেআউট থেকে আসে, এবং সাইডবারে সংখ্যা দেখানো হয়। স্ক্রিপ্ট তালিকা এবং মেটাডেটা স্থানীয়ভাবে ক্যাশ করা থাকে, তাই পরে চালু করলে তা সঙ্গে সঙ্গে খোলে এবং নেটওয়ার্ক সাড়া দেওয়ার আগেই ইউজার ইন্টারফেস ব্যবহারযোগ্য হয়ে যায়। প্রতিটি রিলিজের সাথে একটি লিনাক্স বাইনারি থাকে, এবং একটি এক-লাইনের ইনস্টল স্ক্রিপ্ট hst /usr/local/bin এ ইনস্টল করে দেয় ।

কঠিন অংশ#

লেআউট। টার্মিনালগুলো নিজে থেকেই লম্বা লাইনগুলোকে র‍্যাপ করে, যার ফলে কোনো বিবরণ তার কলামের চেয়ে চওড়া হলেই মাল্টি-পেন লেআউটটি ভেঙে যায়। প্রথম সংস্করণের পরের বেশিরভাগ কাজই ব্যয় হয়েছে প্রতিটি লাইন পরিমাপ করে সেগুলোকে ছোট করা, ফুলস্ক্রিন ডিটেইলস ভিউয়ের জন্য ভিউপোর্টের উচ্চতা পুনরায় গণনা করা এবং একটি ন্যূনতম ব্যবহারযোগ্য প্রস্থ নিশ্চিত করার পেছনে।

অবস্থা#

প্রথম বিটা সংস্করণ প্রকাশিত; রক্ষণাবেক্ষণ করা হচ্ছে।

README.md

MeAshikeqbal/helper-scripts-tui · main

A terminal UI (TUI) for browsing and running Proxmox helper scripts from the community-scripts/ProxmoxVE project.

This app is built with Go and Bubble Tea, supports fuzzy search, category filtering, rich metadata, fullscreen details, variant selection, contextual help, and local caching for fast startup.

Module Path

This repository uses:

github.com/MeAshikeqbal/helper-scripts-tui

Features

  • Dynamic categories from script paths (ct, vm, misc, etc.)
  • Category counts in the sidebar
  • Fuzzy search for script names
  • Script metadata view (resources, tags, notes, config, website)
  • Fullscreen details mode with scrolling
  • Install flow with confirmation
  • Variant selection (for scripts that have variants)
  • Context-aware help overlay (?)
  • Cache-first startup for scripts and metadata
  • CLI flags for version and debug
  • Build-time and VCS-aware version resolution

Requirements

  • Go 1.24+
  • Network access (to fetch scripts/metadata from GitHub)
  • Bash + curl (used to run selected script installers)

Installation

Quick Install (Linux)

Install the latest version with a single command:

bash
curl -fsSL https://raw.githubusercontent.com/MeAshikeqbal/helper-scripts-tui/main/install.sh | bash

This will download the binary and install it to /usr/local/bin/hst.

Manual Binary Install

bash
# Download a specific release (replace version as needed)
curl -L https://github.com/MeAshikeqbal/helper-scripts-tui/releases/download/v0.1.0-beta/hst-linux-amd64 -o hst

# Make it executable
chmod +x hst

# Move to your PATH
sudo mv hst /usr/local/bin/

# Run
hst

From Source

Clone and run
bash
git clone https://github.com/MeAshikeqbal/helper-scripts-tui.git
cd helper-scripts-tui
go run .
Build binary
bash
go build -o hst .
./hst

CLI Flags

  • --version, -v: print version and exit
  • --debug: enable debug startup logs and panic stack trace output

Examples:

bash
hst --version
hst --debug

Versioning

Version is resolved in this order:

  1. Build-time injected value (-ldflags -X main.version=...)
  2. Go module build info version
  3. VCS revision fallback (dev+<sha> or dev+<sha>-dirty)
  4. dev

Release build example:

bash
go build -ldflags "-X main.version=v0.1.0-beta" .

Keybindings

The app has context-aware keybindings and a help overlay.

Open help:

  • ? to open
  • ? or esc to close

Main view

  • Up/Down: move script cursor
  • Left/Right: switch category
  • /: focus search
  • d: open fullscreen details
  • Enter: start install flow
  • q or Ctrl+C: quit

Search mode

  • Type: filter scripts
  • Enter: exit search input
  • esc: clear search and exit search input

Fullscreen details

  • Up/Down or j/k: scroll line
  • PgUp/PgDn or b/f: scroll page
  • Home/End or g/G: jump top/bottom
  • Enter: start install flow for viewed script
  • esc: back to main view
  • q or Ctrl+C: quit

Variant selection

  • Up/Down: choose variant
  • Enter: confirm variant
  • esc: cancel

Confirm install

  • y: run installer
  • n or esc: cancel

Data Sources

Scripts and metadata are fetched from the Proxmox helper scripts upstream:

  • Script tree:
    • https://api.github.com/repos/community-scripts/ProxmoxVE/git/trees/main?recursive=1
  • Metadata index:
    • https://api.github.com/repos/community-scripts/ProxmoxVE/contents/frontend/public/json
  • Metadata files:
    • https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/frontend/public/json/<name>.json

Caching

Cache uses os.UserCacheDir() under:

  • Linux: ~/.cache/helper-scripts-tui/

Files:

  • scripts.json
  • metadata.json

Behavior:

  • Loads cache first for quick startup
  • Refreshes from upstream when needed

Project Structure

code
.
├── main.go            # CLI entrypoint, args, version resolution, panic recovery
├── ui/                # Bubble Tea state/update/view orchestration
├── components/        # Reusable UI renderers (sidebar, scripts, details)
├── services/          # GitHub fetch + cache services
├── model/             # App state model types
├── types/             # Shared data structures (Script, Metadata, etc.)
├── go.mod
└── go.sum

Development

Format and build:

bash
gofmt -w .
go build .

Run from source:

bash
go run .

Security Note

Install runs remote script content through bash:

  • bash -c "$(curl -fsSL <script-url>)"

Always review scripts and trust the upstream source before running installers.

Troubleshooting

  • If startup seems stale, remove cache files in your cache directory.
  • If version is dev, build with -ldflags or from a tagged module context.
  • Use --debug for extra diagnostics and panic stack traces.
GitHub দেখুন