Skip to content

Commit

Permalink
Split manual install instructions out into separate file
Browse files Browse the repository at this point in the history
  • Loading branch information
@thenickdude
thenickdude committed May 2, 2020
1 parent 1c3be49 commit bda96cf
Show file tree
Hide file tree
Showing 4 changed files with 133 additions and 88 deletions.
19 changes: 12 additions & 7 deletions Makefile
View file
Original file line number Diff line number Diff line change
Expand Up @@ -86,17 +86,22 @@ wacom-5.3.7-6-macOS-patched.zip : $(PATCHED_DRIVERS_5_3_7_6) build/ build/Readme
rm -f $@
cp src/5.3.7-6/PenTabletDriver.patched build/PenTabletDriver
cp src/5.3.7-6/ConsumerTouchDriver.patched build/ConsumerTouchDriver
cd build && zip ../$@ PenTabletDriver ConsumerTouchDriver Readme.html
cd build && zip --must-match ../$@ PenTabletDriver ConsumerTouchDriver Readme.html

wacom-6.3.15-3-macOS-patched.zip : $(PATCHED_DRIVERS_6_3_15_3) build/ build/Readme.html
rm -f $@
cp src/6.3.15-3/WacomTablet.patched build/WacomTablet
cp src/6.3.15-3/WacomTabletDriver.patched build/WacomTabletDriver
cd build && zip ../$@ WacomTablet WacomTabletDriver Readme.html
cd build && zip --must-match ../$@ WacomTablet WacomTabletDriver Readme.html

# Render documentation markdown using marked: https://www.npmjs.com/package/marked
build/Readme.html : Readme.md build/ src/readme-prologue.html src/readme-epilogue.html
( cat src/readme-prologue.html; marked --gfm < $<; cat src/readme-epilogue.html ) > $@
build/Readme.html : Readme-manual-installation.md build/ src/readme-prologue.html src/readme-epilogue.html
# Rendering documentation markdown using marked: https://www.npmjs.com/package/marked
# Removes the section which tells the user to unpack the zip, since they've done that already
( \
cat src/readme-prologue.html; \
perl -0777 -pe 's/Make sure you already.*then follow the/To install the fix for your Wacom driver, follow the/igs' $< | marked --gfm; \
cat src/readme-epilogue.html \
) > $@

# Create the installer package by modifying Wacom's original
Install\ Wacom\ Tablet-5.3.7-6-patched-unsigned.pkg : src/5.3.7-6/Install\ Wacom\ Tablet.pkg $(PATCHED_DRIVERS_5_3_7_6) src/5.3.7-6/Welcome.rtf
Expand Down Expand Up @@ -231,7 +236,7 @@ src/6.3.15-3/pentablet_6.3.15-3.dmg :
curl -o $@ "https://cdn.wacom.com/u/productsupport/drivers/mac/professional/WacomTablet_6.3.15-3.dmg"
[ $$(md5 $@ | awk '{ print $$4 }') = "b16906fea82d7375b3e8edee973663f5" ] || (rm $@; false) # Verify download is undamaged

src/6.3.17-5/pentablet_6.3.17-5.dmg : src/6.3.17-5/
src/6.3.17-5/pentablet_6.3.17-5.dmg :
curl -o $@ "https://cdn.wacom.com/u/productsupport/drivers/mac/professional/WacomTablet_6.3.17-5.dmg"
[ $$(md5 $@ | awk '{ print $$4 }') = "42dafc4250df4649f1a122578425bbad" ] || (rm $@; false) # Verify download is undamaged

Expand All @@ -248,7 +253,7 @@ src/6.3.15-3/Install\ Wacom\ Tablet.pkg : src/6.3.15-3/pentablet_6.3.15-3.dmg
cp "src/6.3.15-3/dmg/Install Wacom Tablet.pkg" "$@"
hdiutil detach -force src/6.3.15-3/dmg

src/6.3.17-5/Install\ Wacom\ Tablet.pkg : src/6.3.17-5/pentablet_6.3.17-5.dmg
src/6.3.17-5/Install\ Wacom\ Tablet.pkg : src/6.3.17-5/ src/6.3.17-5/pentablet_6.3.17-5.dmg
hdiutil attach -quiet -nobrowse -mountpoint src/6.3.17-5/dmg "$<"
cp "src/6.3.17-5/dmg/Install Wacom Tablet.pkg" "$@"
hdiutil detach -force src/6.3.17-5/dmg
Expand Down
116 changes: 116 additions & 0 deletions Readme-manual-installation.md
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,116 @@
# Manual fix installation

Make sure you already have the correct Wacom driver installed ([Wacom 5.3.7-6 for Bamboo tablets](http://cdn.wacom.com/u/productsupport/drivers/mac/consumer/pentablet_5.3.7-6.dmg)
or [Wacom 6.3.15-3 for Intuos 3 and Cintiq tablets](http://cdn.wacom.com/u/productsupport/drivers/mac/professional/WacomTablet_6.3.15-3.dmg)),
because the manual method only replaces a couple of the driver's files and doesn't install the complete driver itself.

Now download my patch for your tablet here:

- [Manual patch 5.3.7-6 for Bamboo tablets](https://github.com/thenickdude/wacom-driver-fix/releases/download/patch-5/wacom-5.3.7-6-macOS-patched.zip)
- [Manual patch 6.3.15-3 for Intuos 3 and Cintiq tablets](https://github.com/thenickdude/wacom-driver-fix/releases/download/patch-5/wacom-6.3.15-3-macOS-patched.zip)

Unzip it by double clicking it, then follow the installation instructions that match your tablet:

### Bamboo tablets

First make sure that the Wacom driver is not loaded by running this command in Terminal (paste it in, then press enter to
run it):

launchctl unload /Library/LaunchAgents/com.wacom.pentablet.plist

The unpacked zip file you downloaded will give you files called "PenTabletDriver" and "ConsumerTouchDriver".

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/Application Support/Tablet/PenTabletDriver.app/Contents/MacOS

You should see a file already in there called "PenTabletDriver". Move the new PenTabletDriver file from the zip file
in there to replace it, confirm that you want to overwrite it, and enter your login password to confirm.

**If your tablet supports touch** you have one more patch to install. In Finder, click "Go -> Go to Folder" and paste
this path:

/Library/Application Support/Tablet/PenTabletDriver.app/Contents/Resources/ConsumerTouchDriver.app/Contents/MacOS

Copy the ConsumerTouchDriver file from the zip you downloaded and paste it over the ConsumerTouchDriver file you see
there, enter your password to confirm the replacement.

**We're done installing patches**, so back in the terminal, run:

launchctl load /Library/LaunchAgents/com.wacom.pentablet.plist

After installing, follow the "post-install instructions" section to set the permissions properly.

### Intuos 3 and Cintiq 1st gen tablets

The unpacked zip you downloaded will give you files called "WacomDriver" and "WacomTabletDriver".

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/PreferencePanes/WacomTablet.prefpane/Contents/MacOS

You should see a file already in there called "WacomDriver". Move the new WacomDriver file from the zip file
in there to replace it, confirm that you want to overwrite it, and enter your login password to confirm.

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/Application Support/Tablet/WacomTabletDriver.app/Contents/MacOS

Move the new WacomTabletDriver file from the zip file in there to replace the existing one.

Now either restart your computer, or run these two command using the terminal, to reload the tablet driver:

launchctl unload /Library/LaunchAgents/com.wacom.wacomtablet.plist

launchctl load /Library/LaunchAgents/com.wacom.wacomtablet.plist

Now open System Preferences and try using the Wacom Tablet preference pane, it should be working now.

If you are still having issues with your tablet, follow the next "post-install instructions" section.

## Post-install instructions

Touch your pen tip to your tablet, and it should prompt you visit System Preferences > Security & Privacy > Privacy Tab
to grant the tablet permissions.

On the Accessibility page, click the padlock to unlock the page, then find and tick any `PenTabletDriver`, `WacomTabletDriver`
`TabletDriver` or `WacomTabletSpringboard` entries you see in the list. Do the same on the Input Monitoring page.

If your tablet supports touch, touch the tablet with your finger, it should again prompt you to grant permissions.
On the Accessibility page, tick the `ConsumerTouchDriver` or `WacomTouchDriver` entry.

For Intuos 3 and Cintiq tablets, the driver might only appear on the Input Monitoring page, and you may need to reboot a second time
for it to appear on the Accessibility page too.

**If your Wacom preference pane, pen support, or touch support is not yet working, or the entries never appeared in the
list for you,** you likely had permissions left over from the previous tablet driver, and these stale entries all need to
be removed like so:

On the "Accessibility" page of Security & Privacy, Find anything related to Wacom in the list (e.g. `PenTabletDriver`,
`WacomTabletDriver`, `TabletDriver`, `ConsumerTouchDriver`, `WacomTabletSpringboard`, `WacomTouchDriver`), select them,
and click the minus button to remove them. Go to the "Input Monitoring page" and do the same there.

Now either reboot your computer, or run these two commands in the Terminal, to reload the tablet driver. For Bamboo tablets:

launchctl unload /Library/LaunchAgents/com.wacom.pentablet.plist

launchctl load /Library/LaunchAgents/com.wacom.pentablet.plist

For Intuos 3 and Cintiq tablets:

launchctl unload /Library/LaunchAgents/com.wacom.wacomtablet.plist

launchctl load /Library/LaunchAgents/com.wacom.wacomtablet.plist

This should restore the prompts to ask you to add permissions, so now begin the instructions in this section again.

## Support me

If you enjoyed having your tablet back in action, please consider sending me a tip!

[![Donate button](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CDPRHRDZUDZW4&source=url)

This will help fund me and further development of these fixed drivers.
82 changes: 3 additions & 79 deletions Readme.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -38,11 +38,6 @@ Thankfully I was able to track down the issues and I have patched the drivers to

## Install the fix

You can either have everything installed for you automatically, or install the fixed files yourself manually, pick
one of these options:

### Automatic method

Download the correct installer for your tablet here and double click it to run it, this will install my fixed version of
Wacom's driver:

Expand All @@ -52,82 +47,11 @@ Wacom's driver:
If you get an error message that your Mac only allows apps to be installed from the App Store, right-click on it and click
"Open" instead.

After installing, follow the "post-install instructions" section (further down this page) to set the permissions properly.

### Manual method

Make sure you already have the correct Wacom driver installed ([Wacom 5.3.7-6 for Bamboo tablets](http://cdn.wacom.com/u/productsupport/drivers/mac/consumer/pentablet_5.3.7-6.dmg)
or [Wacom 6.3.15-3 for Intuos 3 and Cintiq tablets](http://cdn.wacom.com/u/productsupport/drivers/mac/professional/WacomTablet_6.3.15-3.dmg)),
because the manual method only replaces a couple of the driver's files and doesn't install the complete driver itself.

Now download my patch for your tablet here:

- [Manual patch 5.3.7-6 for Bamboo tablets](https://github.com/thenickdude/wacom-driver-fix/releases/download/patch-5/wacom-5.3.7-6-macOS-patched.zip)
- [Manual patch 6.3.15-3 for Intuos 3 and Cintiq tablets](https://github.com/thenickdude/wacom-driver-fix/releases/download/patch-5/wacom-6.3.15-3-macOS-patched.zip)

Unzip it by double clicking it, then follow the installation instructions that match your tablet:

#### Bamboo tablets

First make sure that the Wacom driver is not loaded by running this command in Terminal (paste it in, then press enter to
run it):

launchctl unload /Library/LaunchAgents/com.wacom.pentablet.plist

The unpacked zip file you downloaded will give you files called "PenTabletDriver" and "ConsumerTouchDriver".

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/Application Support/Tablet/PenTabletDriver.app/Contents/MacOS

You should see a file already in there called "PenTabletDriver". Move the new PenTabletDriver file from the zip file
in there to replace it, confirm that you want to overwrite it, and enter your login password to confirm.

**If your tablet supports touch** you have one more patch to install. In Finder, click "Go -> Go to Folder" and paste
this path:

/Library/Application Support/Tablet/PenTabletDriver.app/Contents/Resources/ConsumerTouchDriver.app/Contents/MacOS

Copy the ConsumerTouchDriver file from the zip you downloaded and paste it over the ConsumerTouchDriver file you see
there, enter your password to confirm the replacement.

**We're done installing patches**, so back in the terminal, run:

launchctl load /Library/LaunchAgents/com.wacom.pentablet.plist

After installing, follow the "post-install instructions" section to set the permissions properly.

#### Intuos 3 and Cintiq 1st gen tablets

The unpacked zip you downloaded will give you files called "WacomDriver" and "WacomTabletDriver".

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/PreferencePanes/WacomTablet.prefpane/Contents/MacOS

You should see a file already in there called "WacomDriver". Move the new WacomDriver file from the zip file
in there to replace it, confirm that you want to overwrite it, and enter your login password to confirm.

In Finder, click "Go -> Go to Folder" (or press Command + Shift + G), then paste this path in the pop-up window,
and click Ok:

/Library/Application Support/Tablet/WacomTabletDriver.app/Contents/MacOS

Move the new WacomTabletDriver file from the zip file in there to replace the existing one.

Now either restart your computer, or run these two command using the terminal, to reload the tablet driver:

launchctl unload /Library/LaunchAgents/com.wacom.wacomtablet.plist

launchctl load /Library/LaunchAgents/com.wacom.wacomtablet.plist

Now open System Preferences and try using the Wacom Tablet preference pane, it should be working now.
(If you'd prefer to install the fixed files yourself manually, you can use the [manual installation instructions](Readme-manual-installation.md) instead.)

If you are still having issues with your tablet, follow the next "post-install instructions" section.
After installing, follow the instructions in the next section to fix up the tablet's permissions.

## Post-install instructions
## Fix up the tablet permissions

Touch your pen tip to your tablet, and it should prompt you visit System Preferences > Security & Privacy > Privacy Tab
to grant the tablet permissions.
Expand Down
4 changes: 2 additions & 2 deletions Readme.pt-BR.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Depois, remova as permissões de driver desatualizadas:
- Faça o mesmo na guia "Monitoramento de entrada"
- Reinicie o computador

![Remover permissões desatualizadas](screenshots/pt-BR/security-and-privacy-delete.jpg)]
![Remover permissões desatualizadas](screenshots/pt-BR/security-and-privacy-delete.jpg)

Segundo, adicione as novas permissões de driver:

Expand All @@ -54,7 +54,7 @@ Segundo, adicione as novas permissões de driver:
- Na lista exibida, verifique se qualquer componente da lista Wacom tem uma marca de seleção.
- Faça o mesmo na guia "Monitoramento de entrada"

![marca de seleçã](screenshots/pt-BR/security-and-privacy-tick.jpg)]
![marca de seleçã](screenshots/pt-BR/security-and-privacy-tick.jpg)

O mesa digitalizadora deve estar funcionando corretamente agora!

Expand Down

0 comments on commit bda96cf

Please sign in to comment.