সহায়ক স্ক্রিপ্ট TUI
Proxmox কমিউনিটি হেল্পার স্ক্রিপ্টগুলো অনুসন্ধান, পরীক্ষা এবং ইনস্টল করার জন্য একটি টার্মিনাল ইউজার ইন্টারফেস।
এই নিবন্ধটি ইংরেজি থেকে যন্ত্রের সাহায্যে অনুবাদ করা হয়েছে। মূলটি পড়ুন
- কমিট
- 21
- গত বছর
- তারকারা
- 1
- ভাষা
- Go
- শেষ ধাক্কা
- মার্চ 2026
- MIT License
এটা কি#
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:
curl -fsSL https://raw.githubusercontent.com/MeAshikeqbal/helper-scripts-tui/main/install.sh | bashThis will download the binary and install it to /usr/local/bin/hst.
Manual Binary Install
# 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
hstFrom Source
Clone and run
git clone https://github.com/MeAshikeqbal/helper-scripts-tui.git
cd helper-scripts-tui
go run .Build binary
go build -o hst .
./hstCLI Flags
--version,-v: print version and exit--debug: enable debug startup logs and panic stack trace output
Examples:
hst --version
hst --debugVersioning
Version is resolved in this order:
- Build-time injected value (
-ldflags -X main.version=...) - Go module build info version
- VCS revision fallback (
dev+<sha>ordev+<sha>-dirty) dev
Release build example:
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?orescto close
Main view
Up/Down: move script cursorLeft/Right: switch category/: focus searchd: open fullscreen detailsEnter: start install flowqorCtrl+C: quit
Search mode
- Type: filter scripts
Enter: exit search inputesc: clear search and exit search input
Fullscreen details
Up/Downorj/k: scroll linePgUp/PgDnorb/f: scroll pageHome/Endorg/G: jump top/bottomEnter: start install flow for viewed scriptesc: back to main viewqorCtrl+C: quit
Variant selection
Up/Down: choose variantEnter: confirm variantesc: cancel
Confirm install
y: run installernoresc: 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.jsonmetadata.json
Behavior:
- Loads cache first for quick startup
- Refreshes from upstream when needed
Project Structure
.
├── 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.sumDevelopment
Format and build:
gofmt -w .
go build .Run from source:
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-ldflagsor from a tagged module context. - Use
--debugfor extra diagnostics and panic stack traces.