This is another great utility for the Raspberry Pi. Easy to install and easy to use.
There are many open-source, community-developed software projects for Raspberry Pi, yet very few people know about them. Pi-Apps aims to improve that, functioning as a software catalog and standardizing installation.
Pi-Apps is very new and is a work in progress. Please report any errors you encounter.
To install Pi Apps
git clone https://github.com/Botspot/pi-apps /home/pi/pi-apps/install
The install script ensures YAD is installed and creates a menu button. Nothing is modified outside your home directory.
To run Pi Apps
Menu -> Accessories -> Pi Apps, or type
- This is the main window:
Use the main window to quickly browse the selection of apps and easily install them.
- If you double-click an app, or select and app and click Details, you will see the Details window.
- The updater window may pop up when you launch Pi-Apps:
Unless you have a very good reason not to, clicking ‘Update now’ is strongly recommended.
- Pi-Apps Settings can be configured by launching Menu -> Preferences -> Pi-Apps Settings.
- If you click New App in Settings, you can easily create your own Apps with a wizard-style sequence of windows.
It helps you select an icon, create & debug install/uninstall scripts, write a description, and more.
managescript is similar to
apt-get– it handles installing apps, uninstalling them, keeping them updated, and more.
Managedoes not include a GUI, though in some cases a dialog will appear to ask you a question.
- To install an app, run this:
/home/pi/pi-apps/manage install Zoom
- To uninstall an app:
/home/pi/pi-apps/manage uninstall Zoom
- To update a single app:
/home/pi/pi-apps/manage update ZoomNote that if an app is up-to-date, no files will be moved around.
- To check all apps for updates:
/home/pi/pi-apps/manage check-allThis command will return a list of updatable apps, separated by the
- To update all apps:
- To install an app, run this:
- To list all apps:
ls /home/pi/pi-apps/appsNote that this will also list the
templateapp, which contains the default install & uninstall scripts. Please don’t try to install it.
How it works
- Each ‘App’ is simply a small
uninstallscript, two icon sizes, and two text files containing the description and a website URL.
- Each App is stored in its own separate directory.
/home/pi/pi-apps/apps/holds all these app directories. The Zoom app, for example, would be located at
- Because of the contained nature of each app folder, it’s really easy to ‘package’ your own apps: just put the folder in a ZIP file and send it to friends. (or upload it as a new issue so your app can be added to Pi-Apps)
- When you click Install, the selected App’s
installscript is executed.
- When you click Uninstall, the selected App’s
uninstallscript is executed.
/home/pi/pi-apps/This is the main folder that holds everything. In all scripts, it is represented as the
COPYINGThis file contains the GNU General Public License v3 for Pi-Apps.
createappGUI script – this is run when you click “Create App” in Settings.
guiThe main GUI window. This script is responsible for displaying the App list and the Details page.
installThis script is used to install Pi-Apps. Adds a couple menu launchers, and makes sure YAD is installed.
manageThis script handles installing, uninstalling, and updating Apps. It does not check or update any files outside the
pi-apps.desktopThis file is a .desktop launcher, exactly the same as the main Pi-Apps launcher in Menu.
pkg-installIf an App requires some
aptpackages in order to run, its
installscript will run
pkg-install. Pkg-install records which app installed what (in the installed-packages folder BTW), so when you uninstall an App, those packages will be removed.
purge-installedThis does exactly the opposite of
pkg-installThis script is run when an App is being uninstalled. Purge-installed will uninstall all packages the app installed.
README.mdYou are reading this file right now!
settingsThis GUI script is executed when you launch ‘Pi-Apps Settings’ from the Menu.
uninstallUninstalls Pi-Apps and removes the menu launchers. Asks permission to uninstall YAD.
updaterThis GUI script is executed every time the
guiscript is launched. Updater first compares today’s date against the
last-update-checkfile. If it’s time to check for updates,
updaterfirst checks for App updates, then checks for other files/folders that have been modified or created. If anything can be updated, a dialog will open and ask permission to update:
data/This folder holds all local data that should not be overwritten by updates.
settings/This stores the current settings saved by the ‘Pi-Apps Settings’ window. Each file contains one setting. For example, the file
settings/Preferred text editorcontains “geany” by default.
status/This folder stores all installation information for all apps. If you install Zoom, then the
status/Zoomfile will be created, containing “installed”. Installed apps will have this status icon in the app list:
If installation was unsuccessful, then the file will contain “corrupted”. The corresponding icon looks like:
If the app has been uninstalled successfully, the icon is
If the app has never been installed or uninstalled, then its
statusfile will not exist. The icon for that is: . Notice the slight amount of red in the center. That’s how you can tell the difference.
update-status/This folder keeps track of which apps can be updated. Each file’s name is of an app, so
update-status/Zoomstores the update status of the Zoom app. This folder is refreshed whenever
~/pi-apps/manage check-allis run. “latest” means that app is up to date. “new” means that app is new from the repository. (in other words, it does not exist locally) “local” means that app does not exist on the repository. “updatable” means the repository’s version and the local version don’t match.
installed-packages/This keeps track of any/all APT packages each app installed. This folder is written to from the
pkg-installscript. For example, if Pi Power Tools installs
expect, then the
installed-packages/Pi Power Toolsfile will contain “xserver-xephyr expect”.
hidelistThis file contains app names that should be hidden from the app list.
templateshould always be there. If your Pi runs TwisterOS, then
hidelistwill contain several more app names, like balenaEtcher, for example.
last-update-checkThis contains a date in numeric form. (Jan. 1 would be
1, Dec. 31 would be
updaterscript uses this file to keep track of when updates were last checked.
etc/This folder is basically an extension of the main
pi-apps/folder. Its contents don’t need to clutter up the main directory, but they can’t go in
data/because these files should be kept up-to-date.
setting-params/This stores the GUI entries for the Settings window. For example, if I wanted to add a new setting called “Auto donate” with ‘Yes’ and ‘No’ parameters, I’d create a new file called
setting-params/Auto donateand it would contain this:
#Donate automatically to Botspot every time Pi-Apps is launched Yes NoNow, the next time Settings is opened, you will see:
What’s the point? Basically, it allows for a more elegant way to add new settings. With this approach, it’s a lot harder to screw up than with manually editing a bash script.
icons/This stores all the icons that are embedded into various dialogs.
screenshots/Stores screenshots of various dialogs, mainly used as an image hosting service, though I suppose they could come in handy if an offline help dialog was made.
update/This folder holds the latest version of the entire Pi-Apps repository. It’s contents is re-downloaded every time you check for updates. It is used to compare file hashes, detect when an app or file can be updated, and is used to copy new file versions into the main
pi-apps/directory during an update.
Q&A with Botspot
- Why did you develop Pi-Apps?
For a long time I have been saddened by how few people are aware of open-source RPi software projects. Many of these projects are extremely useful and beneficial, but there has never been a good way to distribute them.
The repositories don’t host them, and they usually aren’t advertised very well, so how will people find them?
Most people never find them.
One day I realized: Why not make my own app store that specializes in all the community RPi software projects out there? It will help more users find the software, and at the same time it would provide a super simple way to install them.
(Which would you rather do – click a shiny Install button, or manually type 11 commands?)
- How long did it take to program this?
About two weeks of nearly non-stop coding. It was fun, but excruciating at the same time.