Pi-Assistant icon indicating copy to clipboard operation
Pi-Assistant copied to clipboard

Pi-Assistant is a simple terminal app made for the Raspberry Pi that makes updating the system, installing apps, viewing system information, and more easier than ever

logo Pi-Assistant

version badge license badge made-with-bash badge

NOTE: Pi-Assistant isn't maintained anymore. use at your own risk!

Pi-Assistant is a simple terminal app made for the Raspberry Pi that makes updating the system, installing apps, viewing system information, and more easier and faster, especially if you are new to the Linux command line or you forget the commands.

links

Installation

to install Pi-Assistant, just copy the following into terminal:

$ wget -qO- https://raw.githubusercontent.com/Itai-Nelken/Pi-Assistant/main/install.sh | bash

Install beta version (not always available)

  1. go to the beta branch
  2. download the specific beta scripts you want
  3. replace the "stable" scripts with the "beta" scripts you just downloaded
    Don't update Pi-Assistant or the beta scripts will be replaced with the stable ones

Use Pi-Assistant

Run Pi-Assistant

To run Pi-Assistant, use the menu or Desktop shortcuts. alternatively you can type in terminal (from anywhere) piassist
when running with piassist you can add flags, to see a list off all flags run piassist --help or see the list bellow.

Flags

--help - show all flags and how to use them and exit.
--no-internet - run pi-assistant without checking for internet (use when you want to start Pi-Assistant without a internet connection).
--no-update - don't check for updates on startup.
--version - print version and exit.
--secret - a secret easter egg :upside_down_face:

Some flags have shorter versions

-h = --help
-ni = --no-internet
-nu = --no-update
-v = --version

if you have any questions, check the FAQ before opening a issue please.

Updates

Pi-Assistant checks for updates and if there are installs them automatically on startup.
To update manually, start Pi-Assistant and go to other>update-this-tool if that doesn't work, or you think something is broken with the scripts, run this command:

$ wget -qO- https://raw.githubusercontent.com/Itai-Nelken/Pi-Assistant/main/updater.sh | bash

removal

Pi-Assistant v1.1.1 and later has a removal script in other>remove if you have an earlier version or need to manually remove, open terminal and copy:

$ wget -qO- https://raw.githubusercontent.com/Itai-Nelken/Pi-Assistant/main/uninstall.sh | bash

Screenshots

piassist-mainmenu.png

More screenshots

The system information option

piassist-sys-tools.png

Demo (the output of some of the commands is outdated)

piassist-demo.gif

How a update (on startup) looks like

updater.png

More screenshots page

CHANGELOG

Known issues and bugs

  • zoom menu icon doesn't work for some reason.

Internal stuff (commands used by the scripts)

Updater flags (meant for the internal use of the scripts)

Usage of the updater:

~/Pi-Assistant/updater.sh --flag but change --flag with a real flag or remove it to run the default.
--no-output - update with no extra output (for example don't print 'checking for updates'). used when Pi-Assistant is starting.
--no-ask-exit-output - don't ask to exit and don't print any extra output (has no use as of writing).
--output-no-ask-exit - print extra output but don't ask to exit (used when manually updating).
--all-executable - make all scripts executable (has no use as of writing).

the default is to print extra output and ask to exit.
the flags that have no use are there just to have all options in case I'll need them in the future.

To do:

  • [x] return to main menu instead of exiting when executed command finishes
  • [x] add uninstall script
  • [x] add updater script
  • [x] make updater script to run on startup (disable by using the --no-update flag. the --no-internet flag disables updates as well.)
  • [x] add dialog GUI
  • [ ] add my QEMU debs.
  • [ ] add box86 install script for 64bit OS's
  • [ ] maybe change whole gui to use YAD? or make a GUI using python? or using gtk and c?
  • [ ] implement app "remembering" system - in other words make Pi-Assistant remember every app it installs.

FAQ

Q:

How can I start Pi-Assistant without a internet connection?

A:
run Pi-Assistant from terminal with this command: piassist --no-internet or use the shorter version like this: piassist -ni.

Q:

How can I disable update on startup?

A:
run Pi-Assistant from terminal with the --no-update flag like this: piassist --no-update or use the shorter version like this: piassist -nu.

Notes

system-information uses a external service for checking the public IP address. the exact link the script uses is: http://ipinfo.io/ip/.