Added a README.md file and some pictures

README.md

@@ -0,0 +1,39 @@
+# Gianmarco's dotfiles
+
+## Get my super fancy setup with Polybar, zsh, powerlevel10k and my custom color scheme.
+
+![Screenshot from my r/unixporn post](repopics/screenshot.png)
+
+### Requirements
+
+- **KDE Plasma** for the color scheme and the icon pack;
+- **Polybar** for the status bar (and **Python** for the media player module);
+- **zsh** and **powerlevel10k** for the fancy shell prompt (and **pfetch** if you want the ascii logo thing).
+
+### How to install
+
+After installing the dependencies, place the stuff like you see it in your home directory. Change the settings of your Plasma desktop, of your shell or terminal emulator, make Polybar launch at startup and you should be good to go.
+
+### Explaining some things
+
+#### Polybar
+
+`.config/polybar` contains stuff from [adi1090x's Polybar Themes repo](https://github.com/adi1090x/polybar-themes) with the addition of a custom folder called `gmg` which is a modified version of the `material` theme present in the same base directory. To launch Polybar with my theme, just run the `launch.sh` script with the flag `--gmg`. You might want to make a thing at login that automatically runs the command for you. Also a lot of the stuff in this custom theme has italian text so, unless you like pasta a lot, you might wanna change that.
+
+I've got a few very simple stupid Polybar modules that I've made myself for my workflow. You can see what each of them do at `gmg/user_modules.ini`. The **bell** icon runs `xdotool` to press a key combination associated with **opening and closing Plasma's notification center**, so you might want to adjust that to your setup. Same thing goes for the **down pointing chevron** which **opens and closes Plasma's tray icons**. The **padlock** icon is supposed to **unlock my Plasma vault folder**, so change it if you want, otherwise get rid of it. In `gmg/modules.ini` there are a few changes I've done to the network module: some lines are commented for **Wi-Fi stuff**, I suggest you touch those parameters if you're on a laptop or something.
+
+Again, since this originates from [adi1090x's Polybar Themes repo](https://github.com/adi1090x/polybar-themes) there's some extra stuff that I don't use such as **rofi menus** and some **extra icon modules** that you might be interested in.
+
+#### The Nightmare Magma color scheme
+
+This is **my own custom color scheme** based on Breeze Dark, designed to be the opposite of my other color scheme called [Dream Plasma](https://github.com/gianmarcogg03/dreamplasmacs): **red and dark AF!!!**
+
+![The color palette](repopics/palette.png)
+
+This up here is the color palette, with the main color being **Signature Red** (#EB4034), the same kinda pinkish shade of red I've been using for my own branding. The shades of black have kind of a **warm hue** to them, especially the darker one, adding to the already warm shades of red. These colors are also used in the Polybar config.
+
+#### The Nightmare Magma icon pack
+
+This is just a slightly modified version of the Breeze Dark icons from KDE, the only difference is that all folder icons, including the Dolphin icon, are now... Take a guess... Red!
+
+WIP