summarylogtreecommitdiffstats
path: root/notes.install
blob: c68a0ae637688f3a421811e2b700de56760eea68 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
BOLD='\033[1m'
GREEN='\033[32m'
RESET='\033[0m'

msg_replug() {
	echo -e "${BOLD}${GREEN}Replug${RESET} your tablet if it is connected. This will re-trigger the udev rules accordingly."
	echo
}

msg_starting() {
	echo "The daemon can be started with:"
	echo -e "  $ ${GREEN}otd${RESET}"
	echo "You can fork it to the background and use output redirection to a log file if desired."
	echo "A systemd user service is also provided and can be used instead, assuming you have a correct systemd user graphical-session.target set up:"
	echo -e "  $ ${GREEN}systemctl --user enable --now opentabletdriver.service${RESET}"
	echo
}

msg_modules() {
	echo "You will have to manually unload built-in kernel modules (or reboot) in order for this driver to work properly."
	echo "To unload the module immediately, run:"
	echo -e "  # ${GREEN}rmmod <module>${RESET}"
	echo "Where <module> is 'wacom' if you own a wacom tablet, and 'hid_uclogic' otherwise."
	echo
}

msg_faq() {
  echo -e "As of version 0.6.2.0, having the package installed will ${BOLD}block${RESET} any modules related to drawing tablets"
	echo -e "In the case that you still have issues after following these instructions, the FAQ at ${GREEN}https://opentabletdriver.net/Wiki/FAQ/Linux${RESET} may help."
	echo
}

post_install() {
	echo
	echo -e "${BOLD}Welcome to OpenTabletDriver!${RESET}"
	echo "In order to start using this driver, there are certain things that have to be configured manually."
	echo
	msg_replug
	msg_starting
	msg_modules
	msg_faq
}

post_upgrade() {
  echo -e "${BOLD}Mismatching OpenTabletDriver versions between GUI and daemon isn't supported${RESET}"
  echo -e "Restart your daemon with ${GREEN}systemctl --user restart opentabletdriver${RESET}"
  echo
  if [ $(vercmp $2 0.6.0-1) -lt 0 ]; then
    echo -e "${BOLD}The plugin API and tablet configuration format has changed in OpenTabletDriver 0.6${RESET}"
    echo -e "You may want to clear the contents of the ${GREEN}Plugins/${RESET} and ${GREEN}Configurations/${RESET} folder in ${GREEN}~/.config/OpenTabletDriver/${RESET}"
    echo
  fi
  if [ $(vercmp $2 0.7.0.0pre) -lt 0 ]; then
    echo -e "${BOLD}The plugin API and tablet configuration format has again changed in OpenTabletDriver 0.7${RESET}"
    echo -e "You may want to clear the contents of the ${GREEN}Plugins/${RESET} and ${GREEN}Configurations/${RESET} folder in ${GREEN}~/.config/OpenTabletDriver/${RESET}"
    echo
  fi
  msg_faq
}