EpiConf

EpiConf is a complete configuration pack designed for EPITA students.
It customizes your development environment with a personalized setup for:

• i3
• Vim
• Taskbar
• User Interface
• Command Prompt

---

📦 Installation

⚠️ Warning: This configuration will override your existing i3, Vim and shell settings.
Make sure to back up your current configuration before installing.

Run this in your shell:

curl -L epiconf.getfdn.com | sh -s

During setup, you will be asked to create a password.
This password is not your system password – it is only used to secure your .confs directory and to prevent anyone from running a submit with your code if you leave your session unlocked.
Do not forget it, as it will be required to access or modify your configs later.

🔐 Security note: Never forget to i3lock!

You can also open this documentation anytime with :

epiconf

You can update the config with :

update-conf

And if you want to delete Epiconf and get back to the default config of epita :

reset-conf

reset the config also remove Epiconf settings and startup script.

---

Epiconf Settings

You can change the main settings of the config in .confs/epiconf/config.ini

General

• MOD → Keycaps for I3 (Mod4 = Win, Mod1 = Alt)
• EPICONF_ASCII → Write EPICONF in the top of shell
• INACTIVITY_TIME → Time before auto i3lock (in second)

Wallpaper

• WALLPAPER_TIME → Time before change wallpaper (in second)

Game

• GAMES → Activate games commands (lunar, osu)

Music

• MUSIC_LOADER → Install Spotify and Deezer
• MUSIC → Main music app (spotify, deezer)

Polybar Left

• xworkspaces → Show active and used workspaces

Polybar Right

• afssize → Show the afs size
• memory → Show the RAM utilisation
• cpu → Show the CPU utilisation
• date → Show the date and hour

🖥️ i3 Configuration

Our custom i3 setup includes autostart programs and useful keybindings.

Automatic startup

• Opens a terminal and Firefox on login
• Changes wallpaper every 5 minutes
• Automatically start the scripts located in .confs/epiconf/start_script/

🖼️ You can change the wallapaper in .confs/config/wallpapers/.

⚙️ All startup scripts must be Bash files with execution permissions already set.

Shortcuts

• Win + i → Lock screen (i3lock)
• Ctrl + Shift + L → Matrix i3lock
• Alt + Tab → Switch workspace

---

✍️ Vim Configuration

We have enhanced Vim with useful plugins and shortcuts.

Plugins

• vim-airline → Beautiful status bar
• nerdtree → File tree explorer
• syntastic → Syntax checking
• completor → Auto completor
• indentline → Indentation mark
• vim-move → For move lines with good indentation

Shortcuts

• Ctrl + x → Save and exit
• Ctrl + q → Quit without saving
• Ctrl + s → Save
• Ctrl + z → Undo
• Ctrl + y → Redo
• Ctrl + c → Copy (in visual mode)
• Ctrl + v → Paste (in visual mode)
• Ctrl + t → Toggle file tree
• Ctrl + f → Clang-format file
• Type { ( [ " ' → Auto-pair brackets/quotes
• Snippets:
  • @for → for syntax
  • @jfor → for syntax with j
  • @kfor → for syntax with k
  • @while → while syntax
  • @if → if syntax
  • @elif → else if syntax
  • @else → else syntax
  • @marg → main function
  • @main → main with no arguments
  • @std → classics includes
  • @pd → printf syntax
  • @struct → struct syntax
  • @dbp → main with printf

---

Gdb

A new gdb config:

• Automatic tab
• Automatic C-x C-o

New commands:

• epiconf → Show epiconf commands

---

🛠️ The Taskbar

A new top taskbar displays:

• Current workspace
• Clock
• AFS storage usage
• RAM usage
• CPU usage

---

🎨 User Interface

• Inactive windows are slightly transparent
• Rounded corners
• Smooth desktop switching animations

---

🐚 Command Prompt

New features :

• Cursor become a bar
• Add auto completion

Our shell prompt is inspired by Kali Linux and shows:

• Username
• Current directory
• Git branch & changes

Extra commands

• gtg → Create .gitignore
• ath → Create AUTHORS file
• rdm → Create basic README
• mkarchi → Run all the above at once
• lunar → Play Minecraft
• osu → Play OSU
• nix-clear → Remove orphaned libraries
• bluetooth → Start Bluetooth manager
• cdclone → Clone a git repository and go inside
• add → Do git add and git status (ex: add *)
• push → Do git commit -m and git push (ex: push "Init")
• cf → Do a clang-format -i command
• cfe → Do a cp the .clang-format file in the repository and do a clang-format-epita
• carchi → Create a directory, a .c and a .h
• lc → Make a gcover
• config → Show the config file

Access to .confs is password protected for extra security.

---

📷 Screenshots

📜 License

MIT License – free to use and modify.