Skip to content

Instantly share code, notes, and snippets.

@fevangelou
Last active July 10, 2025 18:57
Show Gist options
  • Save fevangelou/46a2885233c45011ad5c8752f18eac73 to your computer and use it in GitHub Desktop.
Save fevangelou/46a2885233c45011ad5c8752f18eac73 to your computer and use it in GitHub Desktop.
Bash script to install SiS Mirage 3+ graphics drivers on Linux
#!/bin/bash
# Bash script to install SiS Mirage 3+ graphics drivers on Linux
# Supports 671/672MX graphics cards
#
# Created in March 2019
#
# Tested on:
# - Lubuntu 18.04 (32-bit) with X.Org v1.19
# - Xubuntu 18.04 (64-bit) with X.Org v1.20
# installed on a Fujitsu-Siemens Esprimo Mobile v5535 laptop (specs: https://www.notebookcheck.net/Fujitsu-Siemens-Esprimo-Mobile-V5535.9149.0.html)
#
# Execute as root user with:
#
# $ sudo su
# (then type your password)
# $ cd ~/
# $ wget --no-check-certificate https://gist.githubusercontent.com/fevangelou/46a2885233c45011ad5c8752f18eac73/raw/79b407db60589d98e78cd131b56a1652756fb7b2/install_sis_graphics_on_linux.sh
# $ chmod +x install_sis_graphics_on_linux.sh
# $ ./install_sis_graphics_on_linux.sh
#
# IMPORTANT:
# If you X.Org version is not 1.20, edit the variable "XORG_VERSION" below accordingly and re-run the script.
#
# References:
# https://github.com/rasdark/xf86-video-sis671 (driver)
# https://ubuntuforums.org/showthread.php?t=2350126&page=4&p=13599531#post13599531 (how-to)
XORG_VERSION="1.20"
# Check for /etc/X11/xorg.conf
if [ ! -f "/etc/X11/xorg.conf" ]; then
touch /etc/X11/xorg.conf
fi
# Install required packages
apt-get -y install build-essential xorg-dev autoconf automake git libtool-bin xutils-dev inxi
# Build the driver
cd ~/
git clone https://github.com/rasdark/xf86-video-sis671.git
cd xf86-video-sis671/
git checkout for-xorg-$XORG_VERSION
autoreconf
automake
./configure --prefix=/usr --disable-static
make
make install
# Check if the drivers were installed
ls -la /usr/lib/xorg/modules/drivers/sis671*
echo ""
echo ""
inxi -G
echo ""
echo ""
if [ -f "/usr/lib/xorg/modules/drivers/sis671_drv.so" ]; then
# Setup the SiS graphics driver
cat > "/etc/X11/xorg.conf" <<EOF
Section "Device"
Identifier "Configured Video Device"
Driver "sis671"
EndSection
Section "Monitor"
Identifier "Configured Monitor"
EndSection
Section "Screen"
Identifier "Default Screen"
Monitor "Configured Monitor"
Device "Configured Video Device"
EndSection
EOF
# Now reboot
echo ""
echo ""
echo " *** The installation for SiS graphics drivers is now complete *** "
echo ""
echo " === --------------------------------------------------------- === "
echo " === PLEASE REBOOT YOUR SYSTEM NOW === "
echo " === --------------------------------------------------------- === "
echo ""
else
echo ""
echo ""
echo " *** The installation for SiS graphics drivers FAILED *** "
echo ""
echo " === ---------------------------------------------------- === "
echo " === Check your X.Org version! === "
echo " === ---------------------------------------------------- === "
echo ""
fi
@TheSawage
Copy link

Hi! I have question. How can I do that? Like I know that I just downloaded iso from lubuntu website (it can be downloaded here: https://lubuntu.net/lubuntu-18-04-bionic-beaver-released/ ) I only copy that iso file to USB drive, using UNetbootin. And thats pretty much it...Obviously install Lubuntu on your laptop or whatever. And follow the steps that I writed before. But Im such a noob in Linux. So I dont know how to release my own .iso of lubuntu that im using right now.

@Emmanuel65
Copy link

Emmanuel65 commented Aug 20, 2019 via email

@TheSawage
Copy link

TheSawage commented Aug 20, 2019

So what do you want? My iso file with that driver? Ok no problem I will somehow do it. But I dont understad. You just need a fresh install of Lubuntu 18.04 (I dont think that Xubuntu will work) And follow the steps. Extract files from .zip file to your desktop. Run sudo pcmanfm (in Lubuntu) and sisimedia_drv.la sisimedia_drv.so files from your desktop put in /usr/lib/xorg/modules/drivers/ and xorg.conf put in /etc/X11/ of course you need change that file like I writed before. And thats it

@luizfernandonb
Copy link

Hi Sawage, I did exactly what you said but every time I restart the computer, it's got a command line blinking forever and I can't do anything at all

@TheSawage
Copy link

Hi Luiz, you must did something wrong. maybe your xorg.conf is wrong, just delete it, and create another one. Remember if you have 1366x768 resolution. You need change that xorg.conf file

@luizfernandonb
Copy link

I copied exactly xorg.conf as you sent it, and it didn't work

@Emmanuel65
Copy link

Hi. The same for me.

@TheSawage
Copy link

What resolution do you have?

@luizfernandonb
Copy link

The system doesn't even start, I can't know

@TheSawage
Copy link

just tell me your name of notebook

@luizfernandonb
Copy link

I don't remember the model, just know that the brand is N3 Mobile

@TheSawage
Copy link

then i cant really help you. Sry.

@AlexZausF
Copy link

It still runs fine on Xubuntu 20.04 (64-bit) with X.Org v1.20, installed on a Fujitsu-Siemens Esprimo Mobile v5535 laptop.
Thanks for putting all the stuff together...

@srg-n
Copy link

srg-n commented Apr 5, 2020

Runs fine on BenQ Joybook A53, Xubuntu 18.04.4
Thank you.

@Edizz34
Copy link

Edizz34 commented Apr 11, 2020

Hello everyone, I'm new,I would ask you for help, I xubuntu(18.04.4) installed on my PC, my PC has a video card sis 771 671, I tried to do everything but after I install the drivers my PC remains with a black screen, you only see the logo of xubuntu. Sorry for my English but I'm Italian. Please help me I don't know what to do anymore!

@manoaratefy
Copy link

This didn't work for me, Xorg log says (EE) No devices detected after loading sis671 driver.

So, this is my working alternative:

wget http://distrib-coffee.ipsl.jussieu.fr/pub/linux/Mageia/distrib/cauldron/x86_64/media/core/release/x11-driver-video-sis-0.12.0-2.mga8.x86_64.rpm                     
sudo alien -c -k x11-driver-video-sis-0.12.0-2.mga8.x86_64.rpm
sudo dpkg -i x11-driver-video-sis*.deb
ln -s /usr/lib64/xorg/modules/drivers/sis_drv.so /usr/lib/xorg/modules/drivers/

And in my /etc/X11/xorg.conf:

Section "Device"
        Identifier      "sis671"
        Driver          "sis"
        Screen          0
EndSection

Section "Monitor"
        Identifier      "tft"
        Option          "PreferredMode" "1280x800"
        Gamma           1
EndSection

Section "Screen"
        Identifier      "Default Screen"
        Device          "sis671"
        Monitor         "tft"
        DefaultDepth    24
        SubSection "Display"
                Virtual 1280    800
                Depth   24
                Modes   "1280x800@60"   "1024x768@60"
        EndSubSection
EndSection

Section "ServerFlags"
        Option          "IgnoreABI"     "True"
EndSection

Note that I'm using Xubuntu 18.04 LTS.

I think that there is some SiS Mirage 3 like mine which is not compatible with sis761.

@Emmanuel65
Copy link

For those who have Sis 671 working properly on Lubuntu/Xubuntu 18: do you have GRUB_CMDLINE_LINUX_DEFAULT="quiet splash" or GRUB_CMDLINE_LINUX_DEFAULT="iomem=relaxed quiet splash"?

@Edizz34
Copy link

Edizz34 commented May 27, 2020

I have quiet splash

@braniti
Copy link

braniti commented Jun 3, 2020

Thank you for making nice script . I got compilation error on Xubuntu 20.04 on same Fujitsu-Siemens Esprimo Mobile v5535 laptop ... , so I posted to driver developer gurus:
rasdark/xf86-video-sis671#6

@braniti
Copy link

braniti commented Jun 8, 2020

OK i fixed the laptop , I described the steps here : https://unix.stackexchange.com/a/591606/416824 , thank you to "TheSawage". I had two attempts with fevangelou script and your link with ZIP but failed ... Core finding is that you have to stick with ubuntu 18.04.1 , cause higher versions of 18.04.XX will not work ...

@luizfernandonb
Copy link

I found out why the black screen came up when I installed the driver here and I couldn't start Lubuntu, because the driver only supports 671 / 672MX cards, and my video card is 672 :/

@luizfernandonb
Copy link

I hope that someday, there will be support for this card

@sobotkac
Copy link

I managed to install the sis671 driver on an Esprimo v5535 running Debian 10 (Xorg 1.20).

Remarks:

  • only works on i686 architecture (32bit), driver compiles but segfaults under amd64
  • "make install" didn't work for me, so I copied src/sis671_drv.la and src/.libs/sis671_drv.so to /usr/lib/xorg/modules/drivers/ by hand
  • libreoffice writer behaves strange (multiplying text if scrolling on text input), this can be solved with
    "Option NoAccel yes"
    in xorg.conf

@junaidi1212
Copy link

I followed the tutorial, but I got an error in the code

junaidi@junaidi-NEON-MNW:$ git checkout for-xorg-$XORG_VERSION
fatal: not a git repository (or any of the parent directories): .git
junaidi@junaidi-NEON-MNW:
$

@devinfriday
Copy link

Hi, i have followed this tutorial but didn't work. My laptop card is different from 671, here's my inxi -G:
gabrio@AspireLXDE:~$ inxi -G Graphics: Card: Silicon Integrated Systems [SiS] 661/741/760 PCI/AGP or 662/761Gx PCIE VGA Display Adapter Display Server: x11 (X.Org 1.20.5 ) drivers: fbdev (unloaded: modesetting,vesa) Resolution: 640x480@73.00hz OpenGL: renderer: llvmpipe (LLVM 9.0, 128 bits) version: 3.3 Mesa 19.2.8

@zecajunior
Copy link

Screenshot of SiS 672 on Xubuntu 20.04 (64-bit):
Captura de tela_2020-08-31_19-43-37

@pillo-pillo
Copy link

pillo-pillo commented Oct 27, 2020

Thanks a lot this is the only real script that works on my Fujitsu Esprimo 550 laptop with ubuntu/xubuntu 18.04.5.
Greate.

Captura de pantalla de 2020-10-27 22-58-45

@fevangelou
Copy link
Author

Great 👍

@JaquimoSwallow
Copy link

Thank you very much! This works beautifully on Linux Lite 5.2 on my Asus X58C.
Screenshot_2020-11-15_20-35-33

@Edizz34
Copy link

Edizz34 commented Nov 27, 2020

Hi, can someone follow me step by step on how to install this driver.
I didn't understand from line 23 onwards. Thanks

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment