#!/bin/sh

# set up gnome desktop environment for remote access via vnc.

# NOTE: it is important to be running the vncserver as a user who is NOT
#        already running x windowing system.  otherwise, weird and possibly
#        bad things can happen, e.g. your apps show up on display zero
#        rather than on the vnc desktop.

# this script depends on the gnome desktop.  to install the minimal
# parts of gnome needed (as far as i know), run this command:
#
#   sudo apt install gnome-panel gnome-settings-daemon gnome-terminal kwalletmanager metacity nautilus

# references:
#
#   best leads: https://askubuntu.com/questions/475023/how-to-make-vnc-server-work-with-ubuntu-desktop-without-xfce
#
#   https://www.digitalocean.com/community/tutorials/how-to-setup-vnc-for-ubuntu-12
#   https://www.digitalocean.com/community/questions/how-to-install-ubuntu-desktop-and-vnc
#   https://ubuntuforums.org/showthread.php?t=1903220
#   https://askubuntu.com/questions/800302/vncserver-grey-screen-ubuntu-16-04-lts

############################

# reset some variables that could be a problem.

unset SESSION_MANAGER
unset DBUS_SESSION_BUS_ADDRESS
export XKL_XMODMAP_DISABLE=1

############################

# load some extra configuration files if they exist.

[ -x /etc/vnc/xstartup ] && exec /etc/vnc/xstartup
[ -r $HOME/.Xresources ] && xrdb $HOME/.Xresources

############################

# set background to solid color; avoids using bandwidth to transfer pictures.
xsetroot -solid darkgreen
#this does what again?
vncconfig -iconic &

############################

# solid leads from the "best" article above gave us the workable, minimal set
# of x window apps below.
/usr/bin/gnome-panel &
/usr/lib/gnome-settings-daemon &
/usr/bin/metacity &
/usr/bin/nautilus &
/usr/bin/gnome-terminal &

############################

# ------------------------------
# "&@}*(@^!$)_-{%:</~`|#=;" !!!!
# dungeon of pain and suffering.
# "&@}*(@^!$)_-{%:</~`|#=;" !!!!
# ------------------------------

# all content has been deleted from the config dungeon.  the damaged configs
# have been set free to roam in their natural environment of the internet.