Skip to content

Programs

Monix is centred around the terminal, and as a result, we have only included 2 GUI programs, one being a terminal.

The Terminal - Alacritty

Alacritty is simple terminal that just works. We paired it with ueberzugpp to let you view images in the terminal when using yazi.

The File Explorer - Yazi

Fast, terminal-based file explorer. We recommend reading the docs to learn how to navigate it.

The Text Editor - Neovim

Built on top of the Vim editor, Neovim can work as a simple text editor to make quick changes to a complete IDE for software development. We've included a simple configuration so you can add plugins. The config can be found in ~/.config/nvim/.

Adding a Plugin

The included config uses neovim's nativeplugin manager. To add a plugin, simply navigate to ~/.config/nvim/plugin/ and create a file for the plugin you want to add. In this example we're going to add the plugin one-replace. To add one-replace create a file, we'll name it one-replace.lua. Once the file is created, you can paste the plugin configuration for lazy, which is usually included in the plugin's page:

vim.pack.add({
    "https://github.com/dantevazquez/one-replace.nvim",
}, { load = true, confirm = false })

require("one-replace").setup({})

vim.keymap.set("n", "<leader>r", function()
    require("one-replace").open_prompt()
end, { desc = "Quick Search and Replace" })

There you go, you have installed a plugin! Relaunch Neovim and the plugin should work.

Adding LSP for a Language

Adding an LSP is quite simple in this configuration and it is done with no plugins. Here is an example on how to install the Lua language server:

  1. Navigate to ~/.config/nvim/lsp/.
  2. Run the script ./lsp.sh; this will open up a fuzzy finder. In this fuzzy finder select lua_ls. This will install the configuration for the Lua language server in Neovim.
  3. Now you just need to install the language server on your system. In this case you can do pac add lua-language-server. There you have it, restart Neovim and the Lua language server should work in Neovim. To know which language server you need, after installing an LSP config via ./lsp.sh, open Neovim and run :checkhealth lsp. This will tell you what language server you need to install on your system. ll After that check the nix packages and search for the LSP.

The Browser - Chromium

You may prefer Firefox or any other browser, feel free to install them. Chromium is just easy to dynamically theme. Also, you can install web apps in chromium in pages that have the install button in the address bar such as Spotify or Excalidraw, and run them via the application laucher (super+space)

Connect to Wifi - Impala

A simple TUI that lets you connect to Wi-Fi. You can run it by typing impala in your terminal or by launching wifi-picker via the application launcher (super+space).

Connect to Bluetooth - Bluetui

A simple TUI that lets you connect to Bluetooth. You can run it by typing bluetui in your terminal or by launching bluetooth-settings via the application launcher (super+space).

Audio Settings - Wiremix

A simple TUI that lets you control your audio settings. You can run it by typing wiremix in your terminal or by launching audio-settings via the application launcher (super+space).

Display Settings - Restui

A simple TUI that lets you change your resolution and DPI. If your resolution is high and the everything looks very small, you can try increasing the DPI to make everything bigger while keeping your resolution crisp. You can run it in your terminal by typing display-settings in your terminal or by launching it via the application launcher (super+space)

Send Files - Localsend

Send files or clipboard to your computer from your phone via the localsend app on ios or android. In monos, files sent from localsend are automatically received, but if you want to accept or deny incoming files, open up ~/.config/monowm/autostart and remove the --autoaccept flag from the monosend command. You may also send files to your phone or another device with localsend by doing monosend share example.jpg or by selecting files in yazi with space and hittin Shift+S to send the file.

How to install a program

Inorder to install a program, you have to edit your nixos configuarion file in /etc/nixos. However, we have made it easy to install programs. To install a program launch pac-add via the application launcher (super+space). This will open up a fuzzy picker to let you install programs. You may also remove a package by launcing pac-delete. Alternativly you can run pac add or pac remove in the terminal.

Monix comes very barebones out of the box. Here's a list of programs you can install to make your system more complete

  • vlc - A video player
  • firefox - Alterative browser to chromium
  • kdenlive - A video editor