1 files changed, 59 insertions, 0 deletions
diff --git a/README.org b/README.org
new file mode 100755
index 0000000..41a07d7
--- /dev/null
+++ b/README.org
@@ -0,0 +1,59 @@
+#+title: Dotfiles | My Linux setup
+#+OPTIONS: num:nil toc:t
+#+STARTUP: overview
+#+SETUPFILE: org-sourcehut/sourcehut.setup
+#+export_file_name: ../README.md
+* About
+
+Welcome to my dotfiles repository!
+
+Here you will find my custom configuration files for a variety of applications and utilities. All of which are written in org-mode literate configuration format.
+
+All of the configurations in this repository are managed using [[https://www.gnu.org/software/stow/][GNU Stow]], which allows me to easily manage and switch between different configurations for different systems or environments.
+  
+* Configurations
+# + [[file:emacs.org][Emacs]]
+# + [[file:shells.org][Shells]]
+# + [[file:Qtile.org][Qtile]]
+    
+# /Qtile with emacs/
+#  [[file:pictures/showcase2.png]]
+
+Themes I'm using:  
++ [[https://github.com/dracula/rofi][Dracula for rofi]]
++ [[https://github.com/dracula/nyxt][Dracula for nyxt]]
++ [[https://github.com/dracula/qutebrowser][Dracula for Qutebrowser]]
++ [[https://github.com/wimstefan/mocp-themes][mocp-themes]] collection      
+ 
+* Installation
++ clone repository
+
+  #+begin_src bash
+    git clone [email protected]:~thanos_apollo/dotfiles
+  #+end_src
+  
++ Install [[https://www.gnu.org/software/stow/][GNU stow]] 
+  #+begin_src bash
+    paru -S install stow # use your distros package manager instead of paru
+  #+end_src
++ Use stow
+  #+begin_src bash
+    cd dotfiles
+    stow .
+  #+end_src
+If you get any errors due to existing files, rename them with ~_backup~ at the end
+e.g ~mv ~/.bashrc ~/.bashrc_backup~
+
++ Install my system packages for Arch Linux /optional/
+  #+begin_src bash
+    paru -S - < pkglist.txt
+  #+end_src
+
+* WARNING!
+It's important to note that my dotfiles in this repository are constantly evolving, as I am constantly experimenting with new configurations and settings.
+
+While I am happy to share my configurations, *I do not recommend using them as-is on your own system* without careful review and testing.
+
+It's possible that some configurations may not work as expected or may cause issues on your system. Therefore, I strongly recommend taking caution and reviewing any changes carefully before applying them to your own system.
+ 
+