Omahub
← All plugins
G

Astroterm

by gardensazurescens

Launch the Astroterm terminal planetarium from the Omarchy bar

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
8dea94c
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
8dea94c
Reviewed
1 month ago

The plugin is a simple QML bar widget that launches the astroterm terminal planetarium with user-configured options. It performs a geocoding lookup via curl to Open-Meteo for location suggestions, but all commands are properly escaped and no malicious behavior is present.

  • Executes external commands (omarchy-launch-terminal, curl) but only with user-provided settings that are shell-quoted.
  • Makes a network request to Open-Meteo for geocoding, which is benign and does not transmit sensitive data.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/gardensazurescens/omarchy-astroterm --enable
Widgets #bar #quickshell #launcher

Astroterm for Omarchy

A small Omarchy bar widget for launching Astroterm, a terminal-based planetarium. The widget includes a native Omarchy settings popup for location and rendering preferences.

Astroterm is a separate application and must be installed first. The plugin does not download, install, or modify Astroterm.

<p align="center"> <img src="assets/astroterm.png" alt="Astroterm star map" width="720"> <img src="assets/popup.png" alt="Astroterm settings popup" width="420"> </p>

The popup controls the view, while the star map opens in the configured Omarchy terminal.

Features

  • Bar button with a ✦ icon
  • Native settings popup with a searchable location field (geocoded suggestions) and rendering toggles
  • Optional colors, constellation lines, Unicode characters, and azimuthal grid
  • Animation speed presets
  • Right-click launch shortcut
  • Optional desktop launcher and Omarchy menu entry

Requirements

  • Omarchy Quattro with the shell plugin system
  • Astroterm installed from your distribution; the Arch package provides /usr/bin/astroterm automatically
  • curl for location search in the settings popup
  • jq for the optional helper commands below

Install Astroterm before enabling this plugin. On Arch-based Omarchy systems, you can use either:

yay -S astroterm

or Omarchy > Install > AUR > astroterm. No manual PATH configuration is needed after installation.

Install

Install and enable the plugin directly from GitHub:

omarchy plugin add https://github.com/gardensazurescens/omarchy-astroterm.git --enable

The plugin is placed in ~/.config/omarchy/plugins/ and can be moved to a different bar section with:

omarchy bar move PLUGIN_ID --section left

Replace PLUGIN_ID with the id from manifest.json.

Use

  • Left-click the bar icon to open the settings popup.
  • Click Open star map to launch Astroterm with the current settings.
  • Right-click the bar icon to launch the current view without opening the popup.
  • Press Esc to close the popup.

Location

Click the location label (under LOCATION) to edit it. Type a city name and pick one of the geocoded suggestions. The search uses the public Open-Meteo geocoding API and does not require an API key. The name and exact coordinates are saved and passed to Astroterm as --latitude/--longitude. Clear the field to return to Astroterm's default coordinates. Without a stored location, Astroterm uses its own default observer coordinates.

Settings are saved to the widget entry in ~/.config/omarchy/shell.json and apply the next time Astroterm is launched. An already running Astroterm process does not reload command-line options.

Configure From A Terminal

Set a shell variable to the plugin ID from the installed manifest before running these commands:

PLUGIN_ID="$(jq -r '.id' /path/to/installed/plugin/manifest.json)"
omarchy bar set "$PLUGIN_ID" city "Phoenix" --json
omarchy bar set "$PLUGIN_ID" color true --json
omarchy bar set "$PLUGIN_ID" constellations true --json
omarchy bar set "$PLUGIN_ID" unicode true --json
omarchy bar set "$PLUGIN_ID" grid false --json
omarchy bar set "$PLUGIN_ID" speed 1 --json

When a city is set without latitude/longitude, the plugin falls back to Astroterm's --city lookup. Setting latitude and longitude (numbers) together takes precedence and is what the popup writes after you pick a suggestion. The popup is the preferred way to change these values.

Optional Launcher Integration

The repository includes astroterm.desktop and omarchy-menu.jsonc as companion files. omarchy plugin add installs the shell plugin itself, but it does not copy desktop files or merge menu extensions automatically.

To add the desktop launcher, copy astroterm.desktop from the installed plugin directory to ~/.local/share/applications/.

To add the Omarchy menu entry, merge the astroterm object from omarchy-menu.jsonc into ~/.config/omarchy/extensions/omarchy-menu.jsonc. Merge it instead of replacing an existing extension file.

Remove

omarchy plugin remove PLUGIN_ID
rm -f ~/.local/share/applications/astroterm.desktop

Remove the astroterm object from the menu extension if you added it manually.

License

MIT. See LICENSE.