Skip to content

jmcerrejon/PiKISS

Repository files navigation

PiKISS For Raspberry Pi: A Bunch Of Scripts With Menu To Make Your Life Easier

PiKISS Logo

Buy Me a Coffee at ko-fi.com npm version Follow me on X! language top Coinbase

⏰ Estimated hours of work so far

  • 1145 hours

💰 Total amount donated by users & sponsors

  • $2056,07

  • I want to thank for its contributions and help: foxhound311, phoenixbyrd, ptitSeb & Moldytzu, Kreal (krishenriksen.dk).

  • I want to thank my current patrons Bo Martin, Rodney Hester & specially James Carroll for trusting me. ❤️

  • Patrons support me in the past: Jay Edwards, Tomás Delgado, Jeremy Palmer, cxgr, Willie D Kerner Jr, Matthew Michink, Mathew Gracie, Mike A. Torevell, David J Leto, Josiah McCracken.

  • Other users who helped me with donations are: Ben Daghita, Timo Westphal, danoga, Roman Borowinski, Lenny Tua, Dan Suter, nunnz, Pi-Mania, Bernd Titze, Bogdan Moldovan, Thomas Wurgler, Paul Symes, George Kister, Agustino Dominguez, David Leahy, Jonathan Hodges, Mattias True, Sara J Shireman Anderson, Anthony Skiver, Shawn Mullins, Michaël Bortolin, William Norris, Jacob Ehrman, Karsten Schulz, Robert Napier.

  • raspipc.es ❤️

📣 Stay tuned

🤝 Contributors

TL;DR

Just type:

curl -sSL https://git.io/JfAPE | bash

🎥 Check what PiKISS can do for you on my Youtube's channel

ENGLISH

[ Screenshots ]

piKiss_01

piKiss_02

piKiss_03

piKiss_04

[ ChangeLog (dd/mm/yy)]

(10/04/24)

· 📦 ADD: Devs > SQLiteStudio.

(07/04/24)

· 🐛 FIX: Emulatos > mGBA.

(02/04/24)

· 📦 ADD: Games > Unreal Tournament 99.

(28/03/24)

· 🐛 FIX: Config > Vulkan driver.

(15/03/24)

· 👌 IMPROVE: Others > Scrcopy v2.4 with Android 15 support.

(08/03/24)

· 👌 IMPROVE: Config > Vulkan 24.0.0 & libdrm-2.4.120.

· 👌 IMPROVE: Games > Quake: Quakespasm (Quake I) v0.96.1 for aarch64.

· 👌 IMPROVE: Games > Quake: Latest Quake 2 with Vulkan support.

· 👌 IMPROVE: Games > Quake: Quake 3 now with aarch64 support.

· 👌 IMPROVE: Emulators > M.A.M.E. v0.263.

(06/03/24)

· 👌 IMPROVE: Emulators > Unreal Speccy Emulator (ZX Spectrum) for armhf & aarch64.

(05/03/24)

· 👌 IMPROVE: Games > Fallout 2 Community Edition (aarch64).

(24/02/24)

· 👌 IMPROVE: Games > RVGL (AKA Re-Volt) v23.1030 for archhf & aarch64.

(17/02/24)

· 👌 IMPROVE: Emulators > mGBA 0.11 (It supports Game Boy, Game Boy Color & Game Boy Advanced).

(11/02/24)

· 👌 IMPROVE: Games > DXX-Rebirth 0.60 (Descent).

(01/02/24)

· 👌 IMPROVE: Emulators > Redream (Sega Dreamcast).

(26/01/24)

· 👌 IMPROVE: Emulators > RetroArch (Add Shaders).

(24/01/24)

· 👌 IMPROVE: Others > Fixes.

· 👌 IMPROVE: Others > SDL2 (Compile the latest version on your OS).

· 👌 IMPROVE: Minor fixes on helper.sh.

(13/01/24)

· 👌 IMPROVE: Emulators > RetroArch (Add Shaders).

· ❌ REMOVE: Others > Net Tools (deprecated).

· 👌 IMPROVE: Others > Metasploit.

(10/01/24)

· 👌 IMPROVE: Emulatos > Snes9X 1.62.3 & BSNes v115 for 64-bit.

(22/12/23)

· 👌 IMPROVE: Config > Vulkan 23.3.1 & libdrm-2.4.119.

(19/11/23)

· 🐛 FIX: Install script.

· 🐛 FIX: Emulatos > OpenMSX (missing library).

(16/11/23)

· 👌 IMPROVE: Emulatos > mGBA 0.11 for 32/64-bit.

(14/11/23)

· 📦 ADD: Devs > Docker.

· 👌 IMPROVE: Refactor code adapted to RPi 5 on some scripts.

· 🐛 FIX: Install script.

· 🐛 FIX: Games > Duke Nukem 3D 32-bit.

· 🐛 FIX: Devs > VSCode. ...

To see the full list of changes, read the CHANGELOG

[ Introducing PiKISS ]

"Everything that can be automated, should be automated."

Installing an application on Linux is not a complex task. Sometimes you just type sudo apt install and get the application installed with all of its dependencies. But... What if we need to install more than one app such as a web server or it requires many steps to complete the install process? Is it not in the official repositories? What if you want to get rid of input commands?

"Please, make an easy way to set up my WIFI network!"

Don't despair. PiKISS has come to help you...


PiKISS (Pi Keeping It Simple, Stupid!) is made with scripts (Bash) for Raspberry Pi 4 & 5 boards which has a menu that will allow you to install some applications or configure files automatically as easy as possible. The ideal stage is:

  • Raspberry PI OS Desktop Bullseye 32-bit. 64-bit support is comming slowly.

The idea is to offer facilities to manage your operating system, selecting an option in a menu and answer [Yes/No]. If you need to check dependencies, install an app, modify a script at boot, add a line to a file or download other, PiKISS will do it for you.

I included not only the ability to install, but also compile programs. Do you have problems when compiling your favorite emulator? Have you forgotten to modify a line in the source code and now you have to recompile again for 4 hours?. Laugh with PiKISS.

What some users have said about PiKISS:

  • "It could have happened to me!"

  • "That's silly! (I'm going to install it as soon as I get home)"

  • "I don't need to fight with the terminal anymore? Shut up and take my money!." - Easy, it's free.

NOTE: 100% Free of viruses and Trojans. Not available in stores. The author of PiKISS is not responsible if you get bored with your Raspberry Pi because everything is too easy. Online until I wish or Internet is destroyed.

[ Installation ]

Just type:

curl -sSL https://git.io/JfAPE | bash

[ Data Files 🚨 ]

Honestly, I just want to let you get everything done without having to fight with the command line. The project has grown a lot, and the games I own and have been hosted on the internet, can't be there because of Copyright. I don't understand how a game that is older than 15 years old in some cases, has these so restrictive laws in some countries. Someone should do something about it.

My solution to keep this project working is the following: If you have copies saved for your use, just copy those links/paths in a file at res/magic-air-copy-pikiss.txt. You have an example of this file with instructions at ./res/magic-air-copy-pikiss.example. PiKISS will read the links/files/directories in that file and install it for you when is required. Compatible and tested hosters: dropbox.com, archive.org, anonfiles.com, pcloud.com.

You can share this file magic-air-copy-pikiss.txt with your brother/sister if you paid half price for the game and if the laws of your country allow it.

[ Update ]

PiKISS checks if new scripts are available on remote and updates them automatically, but if you want to get the latest version manually, just enter into the directory with cd PiKISS and type:

git pull

NOTE: If you use another distribution other than Raspberry OS/TwisterOS, maybe you need to execute the next command: git config --global http.sslVerify false

[ HELP ME! ]

PiKISS grows up according to users requests or I'll append scripts that I consider necessary, but I call to the community to share, improve and help to add new scripts to the existing one. If the project grow, is up to you.

ESPAÑOL

PiKISS para Raspberry Pi: Un puñado de scripts con menú para hacerte la vida más fácil

[ Presentando PiKISS ]

"Todo lo que pueda ser automatizado, debería estar automatizado."

Instalar una aplicación en Linux no es complejo. A veces basta con un sudo apt install y tendrás la aplicación con todas sus dependencias. Pero, ¿Y si tenemos que instalar más de una app como por ejemplo en un servidor web o necesita varios pasos para completar el proceso de instalación?, ¿Y si no está en los repositorios oficiales?, ¿Y si no quieres teclear? ¡Por favor, una manera fácil de instalar mi red WIFI!.

No desesperéis. Ha llegado PiKISS para ayudarte...


PiKISS (Pi Keeping It Simple, Stupid!, "Pi manteniéndolo sencillo, ¡Estúpido!") son unos scripts en Bash para placas Raspberry Pi 4 y 5 y testeado en Raspberry PI OS Desktop Bullseye 32-bit (el soporte a 64-bit lo estoy haciendo poco a poco), que cuenta con un menú que te va a permitir instalar algunas aplicaciones o configurar ficheros de forma automática de la manera más fácil posible. Su misión: Simplificar la instalación de software en Raspberry Pi.

La idea es ofrecer facilidades para manejar tu distribución y que las instalaciones sean tan sencillas como seleccionar una opción en un menú y contestar [Si/No]. Si alguna conlleva algo más que instalar, por ejemplo modificar un script en el arranque, añadir una línea a un fichero, descargar otros ficheros, comprobar dependencias, PiKISS lo hará por ti.

Incluyo la posibilidad no solo de instalar, sino también de compilar programas. ¿Problemas a la hora de compilar tu emulador favorito?, ¿Se te ha olvidado modificar una línea en el código fuente de su autor y tienes que volver a recompilar durante 4 horas?. Ríete tú ahora de todo esto con PiKISS.

Lo que algunos usuarios han dicho de PiKISS:

  • "¡Se me podría haber ocurrido a mí!"

  • "Menuda tontería (voy a instalarlo en cuanto llegue a casa)"

  • "¿Ya no tengo que pelearme con la terminal?. Cállate y coge mi dinero!" - Tranquilos, es gratis.

NOTA: 100% Libre de virus y troyanos. No disponible en tiendas. El autor de PiKISS no se hace responsable si te aburres con tu Raspberry Pi porque todo es demasiado fácil. Online hasta que me plazca o se destruya Internet.

[ Instalación ]

Escribe en la terminal lo siguiente:

curl -sSL https://git.io/JfAPE | bash

[ Ficheros de datos 🚨 ]

Sinceramente, lo único que quiero es que todo funcione sin tener que pelearme con la línea de comandos. El proyecto ha crecido mucho, y los juegos que yo poseo y que tenía alojados en internet, no pueden estar allí por motivos de Copyright. Tampoco entiendo como un juego que tiene más de 15 años en algunos casos, tienen estas leyes tan restrictivas en algunos países. Alguien debería hacer algo al respecto.

Mi solución para que este proyecto siga funcionando es el siguiente: Si tienes copias guardadas para tu uso, copia dichos enlaces/rutas en el fichero res/magic-air-copy-pikiss.txt. Tienes un ejemplo de este fichero en ./res/magic-air-copy-pikiss.example. PiKISS leerá los enlaces/rutas de ese fichero y te instalará el que necesite cuando proceda. Hosters testeados y compatible: dropbox.com, archive.org, anonfiles.com, pcloud.com.

Este fichero magic-air-copy-pikiss.txt lo puedes compartir con tu herman@ si pagásteis a medias el juego y si las leyes de tu país lo permiten.

[ Actualizar ]

PiKISS comprueba si hay nuevas actualizaciones en remoto y las actualiza automaticamente, pero si quieres conseguir la última versión de forma manual, teclea en el directorio de PiKISS:

git pull

NOTA: Si usas otra distribución que no sea Raspberry OS/TwisterOS en la Raspberry Pi, tal vez tengas que ejecutar esta sencencia: git config --global http.sslVerify false

[ ¡AYÚDAME! ]

PiKISS crecerá de acuerdo a las peticiones de los usuarios o añadiré los scripts que considere oportunos, pero hago un llamamiento a toda la comunidad para compartir, mejorar o agregar nuevos scripts a los ya existentes. Que este proyecto crezca depende de tí.