aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md71
1 files changed, 70 insertions, 1 deletions
diff --git a/README.md b/README.md
index d7a885a..b8da9dc 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,71 @@
-# xfce4
+
+INSTRUCTIONS INSTALLING CRUX-XFCE4 REPO
+=====
+1. First download the necessary files:
+
+ ```bash
+ wget --no-ch https://codeberg.org/jlngn/xfce4/raw/branch/3.8/xfce4.httpup
+ wget --no-ch https://codeberg.org/jlngn/xfce4/raw/branch/3.8/xfce4.pub
+ ```
+
+2. Move the downloaded file to the proper folder:
+
+ ```bash
+ sudo mv xfce4.httpup xfce4.pub /etc/ports/
+ ```
+
+ 4. Create the dir where the ports are contained:
+ ```bash
+ sudo mkdir /usr/ports/xfce4
+ ```
+
+4. Add the ports line in your */etc/prt-get.conf* to fetch the repo:
+
+ prtdir /usr/ports/xfce4
+
+5. Update the repo onto your computer:
+
+ ```bash
+ sudo ports -u xfce4
+ ```
+
+NOTES
+=====
+1. Enable the contrib repo because some dependencies reside there.
+2. The XFCE 4.20 Desktop has been tested on CRUX/CRUX-ARM 3.7 & 3.8. You may need to ignore footprints if you've installed certain software from the official repos.
+3. I'm currently testing some "meta" ports, there is a basic skeleton desktop port which will pull in the bare minimum needed for running the XFCE Desktop. After the repo is setup run:
+
+ ```bash
+ sudo prt-get depinst xfce4
+ ```
+ Please note, it's the bare minimum, and does not contain any gvfs ports, or any other plugins. You will need to then build any extra ports you would like.
+4. Optionally, the experimental labwc Wayland session is available, but requires Wayland support has been compiled into gtk3, mesa and more.
+5. During migration from github to codeberg I've removed elogind related ports. If you want elogind session handling, there is a separite repo available here to add it.
+
+CONTACT
+=====
+If you have any questions, doubts or problems regarding the ports, please feel free to contact me at j at lngn dot net or just open a [issue](https://github.com/mac-a-r0ni/crux-xfce4/issues).
+
+XFCE INSTALLATION
+=====
+1. To ensure you have a sane Xorg installation I decided to put all the Xorg dependencies with the first package you install from XFCE on **libxfce4util**
+2. Install the packages in this **exact order**:
+
+ ```bash
+ sudo prt-get depinst libxfce4util xfconf libxfce4ui udisks2 gvfs garcon exo xfce4-panel thunar thunar-volman xfce4-settings xfce4-session xfwm4 xfdesktop xfce4-appfinder tumbler xfce4-terminal xfce4-power-manager xfce4-notifyd xfce4-screenshooter mousepad xdg-user-dirs
+ ```
+
+3. Get a big cup of coffee and just relax...
+
+4. To launch Xfce create a *.xinitrc* file in your *home* directory with the following content:
+ ```bash
+ #!/bin/sh
+ exec dbus-launch startxfce4 --with-ck-launch
+ ```
+
+5. If you have any problem launching XFCE and you have a an Intel graphic card, install **xorg-xf86-video-intel** and the **mesa** ports from the xorg repo.
+
+6. For apps that need authorization (running as root) on X11 you'll need to install the 'polkit-gnome' and 'pinentry' ports.
+
+7. Enjoy this beautiful Desktop Environment!