Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/xeho91/.dotfiles

My personal dotfiles with the configuration for various tools I use(d) for developing.
https://github.com/xeho91/.dotfiles

dotfiles

Last synced: about 1 month ago
JSON representation

My personal dotfiles with the configuration for various tools I use(d) for developing.

Awesome Lists containing this project

README

        

# Dotfiles

Icon with tools - a wrench on the left and a screwdriver on the right
_The icon is borrowed from [Freepik](http://www.freepik.com/)_

## What are the dotfiles?

> **Dotfiles** are used to customize your system.
> The “dotfiles” name is derived from the configuration files in Unix-like
> systems that start with a dot (e.g. `.bash_profile` and `.gitconfig`).
> For normal users, this indicates these are not regular documents,
> and by default are hidden in directory listings.
> For power users, however, **they are a core tool belt**.

_Quote borrowed from [this source]_

[this source]: https://medium.com/@webprolific/getting-started-with-dotfiles-43c3602fd789

So, in other words, this is a repository which contains my configurations for
the programs in my core tool belt.

---

## Getting started

The goal is to be able to run the installation without any requirements.
The installer is supposed to take care of everything in advance,
to automate the processes.

### Table of Contents

- [Linux logo Instructions for Linux](#instructions-for-linux)
- [Linux logo Instructions for Windows 10](#instructions-for-windows-10)

---

### Instructions for Linux (CURENNTLY OUTDATED)

[Installer file code - `./Linux/install.sh`](./Linux/install.sh)

linux logo

:information_source: Currently optimized for these distributions:

- Debian logo Debian
- Ubuntu logo Ubuntu
- ArchLinux logo Arch Linux

### Step by step guide for Linux

1. **Download the installation file.**\
Type in your shell:

```sh
curl --remote-name "https://raw.githubusercontent.com/xeho91/.dotfiles/main/Linux/install.sh"
```

2. **Read and inspect the code.**\
For example with this command:

```sh
cat install.sh
```

:exclamation: **NOTE**: You can modify the configuration with any text
editor, if you have the knowledge.\
_(See the `Variables for installation configuration` section in the
installer's code, near the beginning of file)_

3. **Make the file executable**.\
Change the file permissions with one of these two commands:

```sh
chmod 700 install.sh
# or
chmod +x install.sh
```

4. **Run this installation file.**\
Type in your shell:

```sh
./install.sh
```

:exclamation: **NOTE**: Don't forget the `./` at the beginning.
That's how you run executable files in Linux.

---

### Instructions for Windows 10

[Installer file code - `./Windows/install.ps1`](./Windows/install.ps1)

Windows logo

### Step by step guide for Windows 10

1. **Run the PowerShell `as administrator`.**

2. **Download the installation file.**\
Type in your shell:

```powershell
curl --remote-name "https://raw.githubusercontent.com/xeho91/.dotfiles/main/Windows/install.ps1"
```

3. **Read and inspect the code.**\
For example with this command:

```powershell
Get-Content install.ps1
```

:exclamation: **NOTE**: You can modify the configuration with any text
editor, if you have the knowledge.\
_(See the `Variables for installation configuration` section in the
installer's code, near the beginning of file)_

4. **Run this installation file.**\
Type in your shell:

```powershell
.\install.ps1
```

:exclamation: **NOTE**: Don't forget the `.\` at the beginning.
That's how you run executable files in Windows.