summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md58
1 files changed, 58 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..264f2f3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,58 @@
+
+
+# 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 [GNU Stow](https://www.gnu.org/software/stow/), which allows me to easily manage and switch between different configurations for different systems or environments.
+
+- Hosted at [sourcehut](https://git.sr.ht/~thanos_apollo/dotfiles)
+
+
+# Configurations
+
+- [Emacs](emacs.md)
+- [Shells](shells.md)
+- [Qtile](Qtile.md)
+
+*Qtile with emacs*
+ ![img](pictures/showcase2.png)
+
+Themes I'm using:
+
+- [Dracula for rofi](https://github.com/dracula/rofi)
+- [Dracula for nyxt](https://github.com/dracula/nyxt)
+- [Dracula for Qutebrowser](https://github.com/dracula/qutebrowser)
+- [mocp-themes](https://github.com/wimstefan/mocp-themes) collection
+
+
+# Installation
+
+- clone repository
+
+ git clone https://github.com/ThanosApollo/dotfiles.git ~/dotfiles
+
+- Install [GNU stow](https://www.gnu.org/software/stow/)
+
+ guix install stow # use the package manager of your distro if not guix
+
+- Use stow
+
+ cd ~/dotfiles
+ stow .
+
+If you get any errors due to existing files, rename them with `_backup` at the end
+
+e.g `mv ~/.bashrc ~/.bashrc_backup`
+
+
+# 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.
+