readme overhaul

This commit is contained in:
Luke Smith 2018-07-10 16:35:22 -04:00
parent 03d1f25612
commit f58290d2e1

View File

@ -2,24 +2,23 @@
[Official Website: larbs.xyz](http://larbs.xyz) [Official Website: larbs.xyz](http://larbs.xyz)
This is a set of scripts either can either (1) install Arch Linux automatically LARBS is a quick series of scripts deployable on a fresh installation of Arch
with a typical Arch ISOed USB, and perhaps more prominently (2) automatically Linux. They automatically install and setup a fully-featured, but still
install and configure all of the prerequisites for an advanced Linux desktop lightweight tiling window manager "suite", meant to be minimal and
environment, using my configs [here](https://github.com/LukeSmithxyz/voidrice) keyboard-based.
as a base.
LARBS is also intensely well-documented. Users can press `super+F1` at any time
to view a full guide and explanation of the keyboard shortcuts. The only
advised foreknowledge for potential users is a general familiarity with vim.
## About Now there are also small scripts like `getkeys` which display the default
bindings for the different terminal programs used by the system. Users can also
press `super+shift+e` at any time to watch a growing list of tutorial videos on
the same programs and other basic concepts from [my YouTube channel](https://youtube.com/c/lukesmithxyz).
Really, the goal of this script is to start a kind of Linux meta-distribution You can also easily fork these scripts for your own purposes to deploy your own
which makes the more nuanced aspects of an advanced Linux setup available to configs if you like. All the actual scripts do is install a `.csv` list of
even Linux newbies. Of course, it's also a great tool for advanced users who programs of your choice and set up system basics.
want to get into tiling window managers and just generally cool-looking and
efficient worksetups.
All the core stuff we be installed without prompt, but you'll have the option
to install some of the larger non-essential packages (LaTeX, LibreOffice,
emacs, etc.).
## Requirements ## Requirements
@ -34,25 +33,18 @@ Pulseaudio and Network Manager after running the script.
### On an already existing Arch install ### On an already existing Arch install
This is just as easy. Log in as the root user and run the following. Boot up a fresh Arch install and run the following as the root user.
```sh ```sh
curl -LO lukesmith.xyz/larbs.sh #Downloads the script. curl -LO lukesmith.xyz/larbs.sh #Downloads the script.
bash larbs.sh #Runs it. bash larbs.sh #Runs it.
``` ```
After prompting you for some settings and some package choices, the system will Once that all is done, you should be able to log out, then log in as your newly
install my full i3-gaps tiling window manager Desktop Environment. If you don't created user and type `startx` to begin the graphical environment. Congrats!
know what that means, don't worry, because I've gone to great lengths to write Note that if the graphical environment doesn't start correctly, you might want
readable instructions about how to go PRO super quick with this system. to see what kind of drivers your computer needs to run Arch and install them
via `pacman` manually.
Finally, it will use `git` to download my
[Voidrice](https://github.com/lukesmithxyz/voidrice)
dotfiles and will plop them in their proper location for instant use!
Then, finally, once that all is done, you should be able to log out, then log in
as your newly created user and type `startx` to begin the graphical environment.
Congrats!
### Installing Arch automatically ### Installing Arch automatically
@ -79,38 +71,21 @@ while. As general dependencies are installed, things will move very quickly.
Still, since this is a total online install, it might take a little longer than Still, since this is a total online install, it might take a little longer than
just installing a distro from an ISO. just installing a distro from an ISO.
## How to Use ## Details
Once you're in the environment, just type `Super` / `Mod` / `Windows` + `F1` to In addition to installing all the needed dependencies, LARBS also:
pull up a document that will explain everything.
## Permission Details (sudoers file)
These script will give your new created user (and those others you put in the
`wheel` group) sudo access (with a password), but will also allow some commands
to be run without any password confirmation. Those include:
+ `shutdown`
+ `reboot`
+ `pacman -Syyu`/`pacman -Syu`
+ `packer -Syyu`/`packer -Syu`
+ `mount`
+ `umount`
+ `systemctl restart NetworkManager`
Additionally, if you've put your password in a terminal window already, you will
not need to repeat putting it in in other terminal windows.
- Enables `wheel` users to run basic commands without passwords including
shuttting down, rebooting and updating packages.
- Installs and enables NetworkManager and Pulseaudio.
- Disables the beep.
## Version ## Version
We're close to what can be called LARBS 2.0, and here are some of the major We're close to what can be called LARBS 2.0, and here are some of the major
changes since the original version. changes since the original version.
- Deployment of my new mutt-wizard for secure offline email configuration - More documentation in the `getkeys` program and `mod+shift-e`.
instead of config files for the user to manually edit.
- System is more minimalist/suckless.
- Luke's build of st is now the default terminal, instead of urxvt. This - Luke's build of st is now the default terminal, instead of urxvt. This
includes: includes:
- Full unicode compatibility - Full unicode compatibility
@ -129,9 +104,14 @@ changes since the original version.
- Status of torrents in transmission-daemon - Status of torrents in transmission-daemon
- Expected date, time, battery, internet and volume modules - Expected date, time, battery, internet and volume modules
- Switch from mocp to mpd/ncmpcpp for music. - Switch from mocp to mpd/ncmpcpp for music.
- System is more minimalist/suckless.
- dmenu is used instead of rofi for simplicity's sake. - dmenu is used instead of rofi for simplicity's sake.
- Deployment of my new mutt-wizard for secure offline email configuration
instead of config files for the user to manually edit.
- Firefox instead of qutebrowser for default browser (qutebrowser configs - Firefox instead of qutebrowser for default browser (qutebrowser configs
remain for qutebrowser afeccionados) remain for qutebrowser afeccionados)
- A default profile of Firefox including some privacy features, an ad-blocker
and VimVixen, for vim-based keyboard shortcuts.
- Extensive implementation of dmenu, including for mounting/unmounting drives, - Extensive implementation of dmenu, including for mounting/unmounting drives,
display selection, confirmation for shutdown and other crucial commands, link display selection, confirmation for shutdown and other crucial commands, link
handling and screen/audio recording. handling and screen/audio recording.
@ -151,31 +131,5 @@ changes since the original version.
### Soon to be added features ### Soon to be added features
- A custom build of Firefox with privacy and efficiently settings and add-ons *At this point, all the planned features are there, and it's now just an issue
for clean and flexible navigation without crap in your face. of fine-tuning them.*
- A little script that can stream tutorial videos directly about specific parts
of the system.
- A terminal command that shows important bindings for major programs.
## Why I made this
When you've installed Arch Linux 6 gorrillian times like me, you get pretty sick
of having to reproduce your favorite configuration on fresh installs over and
over. When you're a C-list YouTube celebrity, it gets even more difficult when
literally thousands of people ask you how to do X or get Y.
The LARBS are a final solution to all of that. These scripts are to be run on a
fresh install of Arch Linux, and they create a user, install all required
programs and set up dotfiles directly from Github to give normal people a fairly
sleek Linux configuration without hundreds of autistic hours. I did the work, so
why should you?
I've also documented the configuration fairly well, check out the documentation
on my **voidrice** repository for that.
## Customization
You can clone and edit the scripts to meet your own requirements, it's simple enough to use your own dotfiles by changing the relevant lines in `larbs_user.sh` and the desired programs in `progs.csv`. Be sure make sure to refer to your offline versions of these files in the scripts if you do so.
In the future, I'm planning even more customization, including the automatic generation of the programs menu, so that should make specialized deployments even easier.