Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dodo325/ohmylinux

setting up your linux is easy!
https://github.com/dodo325/ohmylinux

Last synced: 3 days ago
JSON representation

setting up your linux is easy!

Awesome Lists containing this project

README

        

# Oh my Linux!
Setting up your linux is easy!

[![asciicast](https://asciinema.org/a/427128.svg)](https://asciinema.org/a/427128)

# Getting Started

## Prerequisites

- A Unix-like operating system: macOS, Linux, BSD. On Windows: WSL2 is preferred, but cygwin or msys also mostly work.
- BASH v4 and newer
- git should be installed (recommended v2.4.11 or higher)

## Basic Installation

## Manual Installation

Clone repo:

```bash

git clone https://github.com/dodo325/ohmylinux.git

```
Or

```bash

git clone --recurse-submodules https://github.com/dodo325/ohmylinux.git

```

Start script:

```bash

bash ohmylinux/oh-my-linux

```

# Testing:

## Base:

Load shunit2:

```bash

git submodule init; git submodule update

```
Run tests:
```bash

./test.sh

```

## Docker:

Build:
```bash

docker build -f ./docker/ubuntu -t ohmylinux .

```

Run tests:
```bash

docker run --rm -it --entrypoint bash ohmylinux test.sh

```

Run Bash session:
```bash

mkdir -p build/

docker run --rm -v "$(pwd)"/build/:/app/build/ -it --entrypoint bash ohmylinux

```

# Command Line Interface:

```bash

oh-my-linux - Oh My Linux

Usage:
oh-my-linux [command]
oh-my-linux [command] --help | -h
oh-my-linux --version | -v

Commands:
build Build script
run Run the script

Options:
--help, -h
Show this help

--version, -v
Show version number

Environment Variables:
DEBUG
Enable debug mode
```

## Build

```bash

oh-my-linux build - Build script

Shortcut: b

Usage:
oh-my-linux build [SELECT] [options]
oh-my-linux build --help | -h

Options:
--help, -h
Show this help

--debug, -d
Enable debug mode

--no-logo
Not print logo

--run, -r
Run scripn after building

--sysinfo
Print System info

Arguments:
SELECT
Selecte some scripts

Examples:
cli build
cli build -d -r
cli build "vlc GUI"
cli build --sysinfo "vlc GUI"

```

## Run

```bash

oh-my-linux run - Run the script

Usage:
oh-my-linux run SCRIPT [options]
oh-my-linux run --help | -h

Options:
--help, -h
Show this help

--debug, -d
Enable debug mode

--no-logo
Not print logo

--sysinfo
Print System info

Arguments:
SCRIPT
Script name
```