diff --git a/tutorials/community-way/alpine-tutorial-desktops-openbox-fast-forward.md b/tutorials/community-way/alpine-tutorial-desktops-openbox-fast-forward.md new file mode 100644 index 0000000..f02c503 --- /dev/null +++ b/tutorials/community-way/alpine-tutorial-desktops-openbox-fast-forward.md @@ -0,0 +1,444 @@ +# Alpine OPENBOX desktop setup: FF version +=========================================================== + +Alpine must be previously installed. For a WAYLAND desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md). +For XFCE4 check [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md) + +* [How to use this guide](#how-to-use-this-guide) +* [Preparation](#preparation-openbox-aline) + * [setup OS configuration](#setup-os-configuration) + * [setup system users](#setup-system-users) + * [setup hardware support](#setup-hardware-support) + * [setup audio and video](#setup-audio-and-video) +* [Instalacion XFCE4 Alpine](#instalacion-openbox-apine) + * [Desktop multimedia and media devices](#desktop-multimedia-and-media-devices) + * [Development](#development) +* [Licensing clarifications](#licensing-clarifications) +* [See also](#see-also) + +## preparation Xfce4 Alpine + +**YOU MUST HAVE DIRECT WIRED INTERNET, if not ask for an ISO from VenenuX:** [https://t.me/alpine_linux/762](https://t.me/s/alpine_linux/762) + +#### setup OS configuration + +Feels lost here? check [How to use this guide](#how-to-use-this-guide) section of this document + + +``` +sed -i -r 's|#PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config + +rc-service sshd restart;rc-update add sshd default + +hostname venenux-desktop +echo 'hostname="venenux-desktop"' > /etc/conf.d/hostname +echo "venenux-desktop" > /etc/hostname + +cat > /etc/hosts << EOF +127.0.0.1 venenux-desktop localhost.localdomain localhost +::1 localhost localhost.localdomain +EOF + +cat > /etc/network/interfaces << EOF +auto lo +iface lo inet loopback + +auto eth0 +iface eth0 inet dhcp + +iface eth0 inet6 dhcp + pre-up echo 0 > /proc/sys/net/ipv6/conf/eth0/accept_ra +EOF + +rc-service networking restart;rc-update add networking boot + +cat > /root/.cshrc << EOF +unsetenv DISPLAY || true +HISTCONTROL=ignoreboth +EOF + +cp /root/.cshrc /root/.bashrc + + echo "root:toor" | chpasswd + +apk add tcsh + +add-shell '/bin/csh' + +adduser -D -g "" -u 998 -h /opt/daru -s /bin/csh daru + + echo "daru:daru" | chpasswd + +rm -f /opt/daru/* +mkdir /opt/daru +cat > /opt/daru/.cshrc << EOF +unsetenv DISPLAY +export PAGER=less +set autologout = 6 +set prompt = "$ " +set history = 0 +set ignoreeof +EOF +cp /opt/daru/.cshrc /opt/daru/.bashrc +chown -R daru:daru /opt/daru + +cat > /etc/apk/repositories << EOF +http://dl-4.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/main +http://dl-4.alpinelinux.org/alpine/v$(cat /etc/alpine-release | cut -d'.' -f1,2)/community +EOF + +apk update + +apk add man-db man-pages nano binutils coreutils readline \ + sed attr dialog lsof less groff wget curl terminus-font \ + zip p7zip xz tar cabextract cpio binutils lha acpi musl-locales musl-locales-lang \ + e2fsprogs e2fsprogs-doc btrfs-progs btrfs-progs-doc exfat-utils exfat-utils-doc \ + f2fs-tools f2fs-tools-doc dosfstools dosfstools-doc xfsprogs xfsprogs-doc jfsutils jfsutils-doc \ + testdisk testdisk-doc partimage partimage-doc parted parted-doc util-linux zram-init + +sed -i "s#.*consolefont.*=.*#consolefont="ter-132n.psf.gz"#g" /etc/conf.d/consolefont +setfont /usr/share/consolefonts/ter-132n.psf.gz + +rc-update add consolefont boot +``` + +For more extended info check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-os-configuration) + +#### setup system users + +``` +apk add shadow shadow-uidmap doas musl-locales musl-locales-lang + +cat > /tmp/tmp.tmp << EOF +set history = 10000 +set prompt = "$ " +EOF + +mkdir /etc/skel +cat /tmp/tmp.tmp > /etc/skel/.cshrc +cat /tmp/tmp.tmp > /etc/skel/.bashrc + +cat > /etc/skel/.Xresources << EOF +Xft.antialias: 0 +Xft.rgba: rgb +Xft.autohint: 0 +Xft.hinting: 1 +Xft.hintstyle: hintslight +EOF + +cat > /etc/default/useradd << EOF +# useradd defaults file +HOME=/home +INACTIVE=-1 +EXPIRE= +SHELL=/bin/bash +SKEL=/etc/skel +CREATE_MAIL_SPOOL=yes +EOF + +cat > /etc/login.defs << EOF +USERGROUPS_ENAB yes +SYSLOG_SU_ENAB yes +SYSLOG_SG_ENAB yes +SULOG_FILE /var/log/sulog +SU_NAME su +EOF + +useradd -m -U -c "" -G wheel,input,disk,floppy,cdrom,dialout,audio,video,lp,netdev,games,users,ping general + +for u in $(ls /home); do for g in disk lp floppy audio cdrom dialout video lp netdev games users ping; do addgroup $u $g; done;done +``` + +**WARNING** your user name must be `general`, you can put a "human name" as you wish, later. + +For more details check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-system-users) + +#### setup hardware support + +``` +apk add acpi eudev eudev-doc eudev-rule-generator eudev-openrc pciutils util-linux zram-init \ + fuse fuse-exfat-utils fuse-exfat avfs pcre2 cpufreqd bluez bluez-openrc \ + wpa_supplicant dhcpcd chrony macchanger wireless-tools iputils linux-firmware \ + networkmanager networkmanager-lang networkmanager-openvpn networkmanager-openvpn-lang + +rc-update add udev +rc-update add acpid +rc-update add cpufreqd +rc-update add fuse +rc-update add bluetooth +rc-update add chrony +rc-update add wpa_supplicant +rc-update add networkmanager + +rc-service networking restart + +rc-service wpa_supplicant restart + +rc-service bluetooth restart + +rc-service udev restart + +rc-service fuse restart + +rc-service cpufreqd restart + +``` + +For more details check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md#setup-software-graphical-fonts-and-languajes) + +#### setup audio and video + +``` +apk add xorg-server xorg-server-xnest xorg-server-xnest xorg-server-doc xf86-input-evdev libxinerama xrandr kbd setxkbmap \ + mesa xinit mesa-dri-gallium xf86-video-dummy xf86-video-modesetting xf86-video-vesa xf86-input-libinput + +apk add libxinerama xrandr kbd setxkbmap bluez bluez-openrc \ + dbus dbus-x11 elogind elogind-openrc lightdm lightdm-lang lightdm-gtk-greeter \ + polkit polkit-openrc polkit-elogind udisks2 udisks2-lang \ + gvfs gvfs-fuse gvfs-archive gvfs-dav gvfs-nfs gvfs-lang \ + networkmanager-elogind + +dbus-uuidgen > /var/lib/dbus/machine-id + +rc-update add dbus +rc-update add elogind +rc-update add polkit +rc-update add lightdm + +apk add font-noto-all ttf-dejavu ttf-linux-libertine ttf-liberation \ + font-bitstream-type1 font-bitstream-100dpi font-bitstream-75dpi \ + font-adobe-utopia-type1 font-adobe-utopia-75dpi font-adobe-utopia-100dpi \ + font-isas-misc + +apk add alsa-utils alsa-plugins alsa-tools alsaconf \ + pipewire pipewire-pulse pipewire-alsa pipewire-spa-bluez + +cat > /etc/security/limits.d/audio-limits.conf << EOF +@audio - memlock 256 +@audio - nice -11 +@audio - rtprio 88 +EOF + +rc-service dbus restart + +rc-service elogind restart + +rc-service polkit restart + +rc-service lightdm restart + +``` + +**WARNING** your user name must be `general`, you can put a "human name" as you wish, later. +**HINT** check for some xf86-video packages like `xf86-video-intel`, `xf86-video-amdgpu`, `xf86-video-noveau`, `xf86-video-ati` or `xf86-video-nv` + +## instalacion Xfce4 Alpine + +Since Alpine 3.13 the XFCE4 desktop its GTK3 for 32bit devices its better to use alpine 3.10 +or 3.12 that uses GTK2 for almost all the programs. + +``` +apk add gtk-update-icon-cache hicolor-icon-theme paper-gtk-theme adwaita-icon-theme + +apk add numix-icon-theme numix-themes numix-themes-gtk2 numix-themes-gtk3 numix-themes-metacity numix-themes-openbox numix-themes-xfce4-notifyd numix-themes-xfwm4 + +apk add openbox openbox-doc jgmenu jgmenu-doc pcmanfm lxsession xfce4-terminal xarchiver mousepad \ + xfce4-panel xfwm4-themes xfce-polkit xfce4-skel xfce4-power-manager xfce4-settings \ + xfce4-clipman-plugin xfce4-xkb-plugin xfce4-screensaver xfce4-screenshooter xfce4-taskmanager \ + xfce4-panel-lang xfce4-clipman-plugin-lang xfce4-xkb-plugin-lang xfce4-screenshooter-lang \ + xfce4-taskmanager-lang xfce4-battery-plugin-lang xfce4-power-manager-lang xfce4-settings-lang \ + gvfs gvfs-fuse gvfs-archive gvfs-afp gvfs-afp gvfs-afc gvfs-cdda gvfs-gphoto2 gvfs-mtp \ + network-manager-applet network-manager-applet-lang vte3 \ + libreoffice libreoffice-gnome evince evince-lang evince-doc + +rc-service networking restart + +rc-service wpa_supplicant restart + +rc-service networkmanager restart + +rc-service lightdm restart + +``` + +#### openbox session menu and desktop configure + +**WARNING** the `openbox-doc` package must be installed + +``` +cat > /etc/xdg/openbox/menu.xml << EOF + + + + + + xfce4-terminal + + + jgmenu-run + + + + xfce4-settings-manager + + + + + + + + + + + + + +EOF + +mkdir -p /etc/skel/.config/jgmenu/ +cat > /etc/skel/.config/jgmenu/jgmenurc << EOF +stay_alive = 0 +tint2_look = 0 +position_mode = pointer +terminal_exec = xfce4-terminal +terminal_args = -e +menu_width = 200 +menu_padding_top = 5 +menu_padding_right = 1 +menu_padding_bottom = 4 +menu_padding_left = 1 +menu_radius = 0 +menu_border = 1 +menu_halign = left +sub_hover_action = 1 +item_margin_y = 2 +item_height = 20 +item_padding_x = 4 +item_radius = 0 +item_border = 0 +sep_height = 3 +font = Sans 10 +icon_size = 16 +EOF + +for u in $(ls /home); do mkdir -p /home/$u/.config/jgmenu && cp /etc/skel/.config/jgmenu/jgmenurc /home/$u/.config/jgmenu/jgmenurc; done + +sed -i -r 's|.*xfce-mcs-manager \&.*|xfce-mcs-manager \&|g' /etc/xdg/openbox/autostart + +sed -i -r 's|.*titleLayout.*|NDLSIMC|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|.*keepBorder.*|yes|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|.*animateIconify.*|no|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|[1-9]|14|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|[1-9]|1|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|.*drawContents.*|no|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|kfmclient.*|pcmanfm|g' /etc/xdg/openbox/rc.xml +sed -i -r 's|Clearlooks|Bear2|g' /etc/xdg/openbox/rc.mxl +sed -i -r 's|.*root-menu.*|jgmenu_run|g' /etc/xdg/openbox/rc.xml + +for u in $(ls /home); do mkdir -p /home/$u/.config/openbox; done +``` + +#### desktop integration and device media + +``` +apk add xdg-desktop-portal xdg-desktop-portal-wlr xdg-desktop-portal-lang xdg-desktop-portal-gtk xdg-desktop-portal-gtk-lang +``` + + +#### Desktop multimedia and media devices + +``` +apk add gst-plugins-base gst-plugins-bad gst-plugins-ugly gst-plugins-good gst-plugins-good-gtk \ + libcanberra-gtk2 libcanberra-gtk3 libcanberra-gstreamer wxgtk-media wxgtk3-media wxgtk-lang \ + mediainfo ffmpeg ffmpeg-doc ffmpeg-libs lame lame-doc rtkit rtkit-doc \ + mpv mpv-doc deadbeef deadbeef-lang libxinerama xrandr + +for u in $(ls /home); do for g in plugdev audio cdrom dialout video netdev; do addgroup $u $g; done;done + +cat > /etc/network/interfaces << EOF +auto lo +iface lo inet loopback +EOF + +service networking restart + +service wpa_supplicant restart + +service networkmanager restart + +``` + +#### development + +``` +apk add pkgconf make cmake gcc gcc-gdc gcc-go g++ gcc-objc gcc-doc \ + patch patch-doc patchutils patchutils-doc diffutils diffutils-doc \ + git git-cvs git-svn github-cli git-diff-highlight git-doc \ + subversion subversion-doc mercurial mercurial-doc \ + geany geany-plugins-lang geany-plugins-addons geany-plugins-geanyextrasel \ + geany-plugins-overview geany-plugins-geanyvc geany-plugins-treebrowser \ + geany-plugins-tableconvert geany-plugins-spellcheck geany-plugins-shiftcolumn \ + geany-plugins-utils geany-lang \ + terminator terminator-lang tmux screen meld meld-lang +``` + +## How to use this guide + +This guide **structure all the commands in blocks, each block its separated by a line spaced**, +so you must **type each line as is.. and hit enter**, so you noted that then you +typed each separated clocks of commands, copy/type only blocks separated by an empty line, +all new(next) lines are made by just enter. the terminal will detect if must execute or not. + +**If you have another computer or gui**, try to use SSH client like putty or just in terminal (MAC or Linux) do: + +1. at the Alpine installation: `sed -i 's|.*PermitRootLogin.*|PermitRootLogin yes|g' /etc/ssh/sshd_config;service sshd restart` +2. at the other OS just connect: `ssh -l root ` change "``" with the address of your device. +3. copy each separated by empty line, block of command, copy only blocks separate by empty line +4. and paste each separated by empty line block in the remnote (ssh), do not paste all the blocks at same time! + +**CAUTION** Some Linux or/and Mac terminals have security cut/paste locks, so +if you paste, the first line will be preceded by garbage, check always the first char of your paste. + +**WARNING** after finish, rerun: `sed -i -r 's|.*PermitRootLogin.*|PermitRootLogin no|g' /etc/ssh/sshd_config` +and restart ssh `service sshd restart` becouse security implications. + +#### hardware used + +| item | minimal feature | Extra recommendations | +| ---------------- | ----------------- | ---------------------------------- | +| RAM MB | 1Gb DDR1 | 6Gb DDR3, web browsers consumes so much | +| CPU | intel Dual Core | Not necesary | +| RAM CPU | 2Mb (L2) 4kb/L1 | | +| GPU | intel G41 | Radeon X1200 For web browsers and modern apps will be need | +| RAM GPU | 256Mb | 1Gb For web browsers and modern apps will be need | +| Storage | 120Gb HDD WD | 256Gb SSD are mandatory for speed | +| ARCH | 32bits (i386/arm6)| 64bits (amd64) mandatory for most modern apps unfortunatelly | +| Audio | AC 97 | HD audio and HDMI audio are a mess | + +#### usernames + +| item | name | password | +| --------- | ------------------- | -------- | +| remote | daru | daru | +| admin | root | toor | +| user | general | general | + + +## Licensing clarifications + +**CC BY-NC-SA**: the project allows reusers to distribute, remix, adapt, and build upon the material +in any medium or format for noncommercial purposes only, and only so long as attribution is given +to the creators involved. If you remix, adapt, or build upon the material, you must license the modified +material under identical terms, includes the following elements: + +* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor. +* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here! +* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it. + +https://codeberg.org/alpine/alpine-wiki/src/branch/main#license + +## See also + +* [README.md](README.md) +* [alpine-newbie-install.md](../../newbie/alpine-newbie-install.md) +* [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)