Skip to content

Istar Pack v1.0.0 — First public release

Latest
Latest

Choose a tag to compare

View all tags
@Israleche Israleche released this 05 Jul 00:56
v1.0.0
1568f34

Istar Pack v1.0.0

One-shot PowerShell terminal setup with six built-in Oh My Posh themes. Works on Windows PowerShell 5.1 and PowerShell 7+. No manual JSON editing, no copy-pasting profile snippets, no chasing down which module goes where.

Download Istar-Pack.ps1 and run-istar-pack.bat, drop them in the same folder, and double-click the .bat. That is the whole install.

Downloads

File Purpose
Istar-Pack.ps1 The script itself. Single file, UTF-8 with BOM.
run-istar-pack.bat Double-click launcher. Handles execution policy and PS edition.
Source code (zip) Full repository snapshot (GitHub-generated).
Source code (tar.gz) Full repository snapshot (GitHub-generated).

The two files above are all most users need. Put them in the same folder and double-click run-istar-pack.bat.

What it does

Istar Pack turns a fresh Windows machine into a fully loaded terminal workstation in one run. It installs:

  • Scoop — Windows package manager (installed only if missing).
  • Oh My Posh — prompt renderer.
  • Zoxide — smarter cd replacement (z <part-of-path>).
  • FZF — fuzzy finder, wired into PSReadLine for Ctrl+t and Ctrl+r.
  • 7-Zip — archive tool, used by the extract function in the profile.
  • Git — required by Scoop for bucket operations.
  • Cascadia Code Nerd Font — for powerline glyphs and file-type icons.
  • Terminal-Icons, PSReadLine, PSFzf, and (on PS 7+) CompletionPredictor modules.

Then it writes a hardened PowerShell profile tuned for your edition, with the theme you selected, and backs up your previous profile to $HOME\.istar-pack\backups\ before overwriting.

Six built-in themes

Key Name Description
GardensDream Garden's Dream Minimalist green. The signature Istar Pack look.
MidnightCyber Midnight Cyber Dark blue with neon cyan accents. Cyberpunk vibe.
SakuraBloom Sakura Bloom Pink / magenta pastel. Soft and warm.
SolarFlare Solar Flare Orange-red on dark. Bold and energetic.
MonoSlate Mono Slate Pure grayscale. Maximum focus, zero distraction.
DraculaReborn Dracula Reborn Classic Dracula palette (purple / pink / cyan).

Each theme is a self-contained Oh My Posh v2 JSON definition embedded in the script. No theme files are downloaded from the internet.

When you pick a theme, the Istar Pack interface itself recolors to match — the banner, the progress bar, and the box accent colors all follow your selection.

Highlights

  • One-shot install. Run once, pick a theme, press Enter. Done.
  • Cross-edition support. Auto-detects PS 5.1 vs PS 7+. PS 7 gets HistoryAndPlugin prediction and the native `e escape; PS 5.1 gets History prediction and [char]27.
  • Theme-aware TUI. The whole Istar Pack interface recolors to match the active theme.
  • Smooth arrow-key navigation. The menu uses differential redraw: only the two changed rows are repainted on each key press. No flicker, no lag.
  • Auto-growing console. Tries to grow the window to 50 rows on launch so the tall screens (Verification, Theme Catalog, About) fit without being cut off. Falls back to a tall scrollback buffer if the window cannot grow.
  • Backup before overwrite. Your existing profile is copied to $HOME\.istar-pack\backups\ with a timestamp before it is replaced.
  • JSON settings persistence. Theme choice, toggles, and last-install timestamp are saved to $HOME\.istar-pack\settings.json and restored on next launch.
  • Silent mode. run-istar-pack.bat -Silent for non-interactive installs.
  • No administrator privileges required. Scoop installs into your user profile.

What the profile fixes

The profile that Istar Pack writes addresses several long-standing issues found in typical PowerShell setup guides:

  • UpArrow / ListView conflict. PSReadLine's ListView prediction view binds UpArrow to navigate the prediction list, conflicting with UpArrow for history. The profile binds Ctrl+UpArrow / Ctrl+DownArrow for prediction navigation instead.
  • Missing 7z dependency. The extract function verifies 7z is on PATH before calling it, with Expand-Archive as a fallback for plain .zip files.
  • False async claim. The oh-my-posh --shell flag is dropped in favor of the synchronous initializer, which is more reliable on Windows.
  • Deprecated acrylicOpacity. Removed from any generated Windows Terminal snippets.
  • Wrong PS version requirement. PS 7-only features are guarded by an edition check, not a version gate.
  • History quality of life. MaximumHistoryCount raised to 4096, HistoryNoDuplicates enabled, HistorySearchCursorMovesToEnd enabled.
  • Safe module loads. Modules load inside try/catch so a missing module never breaks the prompt.

Quick start

  1. Download Istar-Pack.ps1 and run-istar-pack.bat from this release.
  2. Place both files in the same folder.
  3. Double-click run-istar-pack.bat.
  4. Use the arrow keys to pick Full install (recommended) and press Enter.
  5. Wait for the install to finish.
  6. Close and reopen your terminal. You should see the new prompt with your selected theme.

Prefer the command line? Either of these works:

.\Istar-Pack.ps1
.\run-istar-pack.bat

For a non-interactive install:

.\run-istar-pack.bat -Silent

Requirements

  • Windows 10 or Windows 11.
  • PowerShell 5.1 or later. Both editions are supported.
  • Internet access for the first run (Scoop bootstrap, module downloads, font download).
  • No administrator privileges required.

Configuration

Settings, backups, and runtime state live in your user home so they survive re-downloads and script moves:

Path Purpose
$HOME\.istar-pack\settings.json Theme choice, toggles, last-install timestamp.
$HOME\.istar-pack\backups\ Timestamped copies of your previous profile.
$HOME\Documents\PowerShell\ PS 7 profile directory.
$HOME\Documents\WindowsPowerShell\ PS 5.1 profile directory.

Uninstall and rollback

To roll back to your previous setup, copy the most recent file from $HOME\.istar-pack\backups\ to your profile path and rename it to Microsoft.PowerShell_profile.ps1. Restart your terminal.

To fully uninstall the tools Istar Pack installed:

scoop uninstall oh-my-posh zoxide fzf 7zip git
scoop uninstall scoop
Uninstall-Module Terminal-Icons -Force
Uninstall-Module PSFzf -Force
Remove-Item -Recurse -Force $HOME\.istar-pack

The Nerd Font can be removed from Settings > Personalization > Fonts (look for "Cascadia Code NF").

Known limitations

  • Windows-only. Scoop is not available on Linux or macOS.
  • The Nerd Font is installed for the current user only. System-wide font installation would require elevation.
  • The auto-grow console feature may not work on terminals that lock the window size. In those cases, a tall scrollback buffer is left in place so the user can scroll.
  • Custom themes are not supported through the Istar Pack UI. Use one of the six built-in themes, or manually replace the theme JSON after install.

Documentation

  • README — install, usage, themes, troubleshooting, FAQ: see the repository README.
  • CHANGELOG — full version history: see CHANGELOG.md in the repository.
  • Contributing — bug reports, feature requests, pull requests: see CONTRIBUTING.md.

Feedback

  • Found a bug? Open an issue using the Bug report template.
  • Have an idea? Open an issue using the Feature request template.
  • Want a new theme? Open a feature request with the colors and layout you have in mind.

Thank you for trying Istar Pack.

Assets 4
Loading