Post Installation Guide
After install you must reboot to apply the changes.
After reboot, make sure dispaylink is running, i.e:
systemctl status dlm.service
If it's not running, start it by running:
systemctl start dlm.service
To start automatically at boot run:
systemctl enable dlm.service
Setting provider sources
Check providers, i.e:
If you get a list of more then one provider, it means your displays were detected.
- Set provider sources, i.e:
xrandr --setprovideroutputsource 1 0 xrandr --setprovideroutputsource 2 0
This will connect you to two external monitors.
Screen Layout Configuration
There are couple of tools to help you configure screen layout of your external monitors.
Depending on your setup, to connect provider 1 to provier 0, you'd run:
xrandr --output DVI-1-0 --auto --right-of eDP1
For further reference I suggest reading: How to use xrandr
If you're GNOME desktop user, simply run:
Another very easy and intuative (gui) tool is
arandr (Another XRandR GUI)
Make sure to install it first:
sudo apt-get install arandr
Since hotplug doesn't work (on Debian) and every time you connect your computer to Displaylink you'll need to re-configure your displays.
I've set-up couple of aliases which help me accomplish this in semi-automated manner.
Every time I connect my computer to DisplayLink ...
I simple run
two which is an alias for setting up two external displays as primary and secondary, whilst turning off laptop built in display. So I can close the lid.
Every time I want to diconnect my displays I run
one. Which turns off both external displays, turns on built in laptop display and makes it a primary (default behaviour).
I did this by simply adding following code to my
# two alias two="xrandr --setprovideroutputsource 1 0 && xrandr --setprovideroutputsource 2 0 && xrandr --output VIRTUAL1 --off --output DVI-1-0 --primary --auto --pos 0x0 --rotate normal --output DP1 --off --output HDMI2 --off --output HDMI1 --off --output eDP1 --off --output DVI-2-1 --auto --pos 1680x0 --rotate normal" # one alias one="xrandr --output VIRTUAL1 --off --output DVI-1-0 --off --output DP1 --off --output HDMI2 --off --output HDMI1 --off --output eDP1 --primary --mode 1366x768 --pos 0x0 --rotate normal --output DVI-2-1 --off"
Note, in case you're editting
~/.bashrc, make sure you run
source ~/.bashrc to appy the changes without having to log in/out.
Troubleshooting most common issues
dmesgoutput while plugging in Displaylink
Most common Ubuntu related issues:
- displaylink.service fails to start
UEFI needs to be disabled. Reference: issue #15
Most common Debian Jessie related issues:
- systemctl status dlm.service failure
- Glibc GLIBCXX_3.4.21 missing
Due to older version of libstdc++6 in Jessie, you need to download and install version from Stretch release. After package has been updated, run displaylink-debian and select "Re-install" option.
Reference: issue #42
Should you experience problems with the display either remaining black, only showing mouse pointer or a frozen image of your main screen, then this could be due to Intel graphics driver interfering with displaylink.
Reference: issue #68
syntax error near unexpected token `newline'...
If you just downloaded the script and tried to execute it, you might get the following error:
$ ./displaylink-debian.sh ./displaylink-debian.sh: line 1: syntax error near unexpected token `newline' ./displaylink-debian.sh: line 1: `<!DOCTYPE html>'
The line number might be different.
Download the script again as a ZIP file: https://github.com/AdnanHodzic/displaylink-debian/archive/master.zip
Extract it and run it:
$ unzip displaylink-debian-master.zip Archive: displaylink-debian-master.zip 075594536fe4683a5e25aec99e3b6379662ef2ea creating: displaylink-debian-master/ inflating: displaylink-debian-master/README.md inflating: displaylink-debian-master/displaylink-debian.sh inflating: displaylink-debian-master/post-install-guide.md $ cd displaylink-debian-master $ sudo ./displaylink-debian.sh
Having a different problem?
Please submit an issue