Contributing

Development of the distro is done on GitHub

Todo

here is a list of all things that still need to be done. Help with any of these is highly appreciated. If you plan on introducing a new feature, be sure to discuss it with the developers first to make sure it is actually wanted and does not already exist.

Repo info

Here’s a rundown of what is contained in repositories and what each of them do

instantOS

This repo is used to build the instantutils package. It contains basic utilities used all around instantOS like the autostart script, notification center, some configuration files and some more specific utilities. For example the instantmouse utility for changing mouse sensitivity or the appmenu wrapper for the graphical application menu are found here.

instantWM

The Window Manager

instantMENU

The menu system. It is responsible for things like the start menu, quick menu, shutdown menu and can also be used as a dmenu replacement (of which it is a fork) used to build the instantmenu package

instantOS/dotfiles

Dotfiles shipped with instantOS used to build the instantdotfiles package

extra

Contains all PKGBUILD files for instantOS packages and a list of AUR packages to be precompiled and hosted on the instantOS repos

instantWALLPAPER

A wallpaper scraper that generates wallpapers with the instantOS logo (or without it). It is also used to set and scale the wallpapers. It makes use of nitrogen and imagemagick.

instantCONF

A small configuration utility that serves as an easy way to store and retrieve settings. Provides the iconf utility

instantTHEMES

This contains theming files for instantOS that make as much applications as possible conform to the overall system look. It also provides a way to switch between a light and dark theme.

instantSHELL

The zsh and oh-my-zsh configuration along with a custom oh-my-zsh plugin used to build the instantshell package

instantSETTINGSfrank

The GUI control panel for configuration of lots of different things used to build the instantsettings package

iso

Everything needed to build an instantOS live iso

liveutils

Everything that is contained on the live installation disk but not on the installed version

sent

Just regular sent with instantOS color scheme and font. Not really relevant to the rest of the system.

imenu

A wrapper script for instantMENU, fzf and dialog. With it you’re able to create prompts that will work in a graphical environment and in a terminal. It will use the different programs depending on the mode but will always accept the same options and generate the same output. It is being used in the instantARCH installer.

mirror

A mirror of all binary packages hosted int the instantOS pacman repo

instantTOOLS

A set of scripts used for instantOS development

instantWELCOME

The welcome prompt coming up on the installation medium and on a fresh system

instantLOCK

The lock screen. This is a very basic slock fork

instantOS-arm

A community maintained ARM edition of instantOS in early stages of development.

islide

Basically dmenu but for sliders instead of text selection. Used for volume and brightness sliders

wallpapers

Just a collection of pictures included as a category in instantWALLPAPER

instantMETA

A completely empty package used as a placeholder for git links

snap-dummy

instantOS doesn’t ship with pre-enabled snap support. This tells you not to use them because they’re resource heavy, unstable and unsafe (loads of proprietary low quality applications with no review process and access to your home directory) and basically proprietary. It then offers to enable snap support if you still really want/have to.

instantSUPPORT

Like teamviewer but for ssh and really small and for instantOS support

instantWIDGETS

Conky widget configuration for instantOS

st-instantos

The default terminal emulator for instantOS, a very simple st fork with some patches and fixes.

grub-instantos

The grub theme for instantOS. This only contains the theme, nothing else.

rox-filer

A basic fork of rox-filer to be used for optional desktop icons.

instantDEB

A way to create Debian packages from arch PKGBUILD files. Originally created to enable a Debian edition of instantOS. Not much work has been done here as of recently.