https://wiki.archlinux.org/api.php?action=feedcontributions&user=Bbaserdem&feedformat=atomArchWiki - User contributions [en]2024-03-29T12:08:53ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=MATLAB&diff=649898MATLAB2021-01-26T05:02:01Z<p>Bbaserdem: /* Installing from the AUR package */ Each version of matlab uses slightly different methodology; and the instructions don't apply to 2020a and onward. I refer to the instructions in the matlab package instead; as it changes from version to version.</p>
<hr />
<div>[[Category:Numerical analysis]]<br />
[[ja:MATLAB]]<br />
[[zh-hans:MATLAB]]<br />
{{Related articles start}}<br />
{{Related|Octave}}<br />
{{Related|Sage-mathematics}}<br />
{{Related|Mathematica}}<br />
{{Related articles end}}<br />
{{Style|unnecessarily verbose}}<br />
From the [http://www.mathworks.com/products/matlab/ official website]:<br />
<br />
:''MATLAB is a high-level language and interactive environment for numerical computation, visualization, and programming. Using MATLAB, you can analyze data, develop algorithms, and create models and applications. The language, tools, and built-in math functions enable you to explore multiple approaches and reach a solution faster than with spreadsheets or traditional programming languages, such as C/C++ or Java.''<br />
<br />
== Overview ==<br />
<br />
MATLAB is proprietary software produced by The MathWorks and requires a license to obtain, install, and activate. New versions of MATLAB are released twice a year,<br />
release names are composed of {{ic|R}}, the year of the release and {{ic|a}} or {{ic|b}}.<br />
Since R2012b MATLAB has only been available for 64-bit Linux. Arch Linux is not officially supported.<br />
[http://www.mathworks.co.uk/support/sysreq/current_release/index.html]<br />
<br />
== Installation ==<br />
<br />
A complete copy of the MATLAB software must be obtained before it can be installed. The MATLAB software is available to licenses holders on both a DVD and through the [http://www.mathworks.com The MathWorks website]. In addition to the software a file installation key is required for installation. It is possible to install MATLAB either with the {{aur|matlab}} package from the [[AUR]] or from the MATLAB installation software directly. The advantage of the {{aur|matlab}} package is that it manages dependencies and some of the nuances of the installation process while installing directly from the MATLAB installation software can be done by regular users to their home directories and works for any release of MATLAB (the {{aur|matlab}} package only works for releases including and after R2010b). <br />
<br />
=== Installing from the MATLAB installation software ===<br />
<br />
The MATLAB installation software is self contained and does not require any additional packages to install in silent mode. To install with the GUI a working [[Xorg]] graphical display is necessary. [[Wayland]] is not currently supported yet, at least not for the GUI; however, plotting seems to work. The installation is handled by the {{ic|install}} script. You can run the script as root to install MATLAB system-wide or your user to install it only for you. On version R2020 the normal {{ic|install}} script may not work, however, the legacy install script {{ic|ISO-DIR/bin/glnxa64/install_unix_legacy}} does work [https://bbs.archlinux.org/viewtopic.php?pid=1928258#p1928258].<br />
<br />
MATLAB 2016a and earlier is not compatible with {{Pkg|ncurses}} 6, so you must install the {{AUR|ncurses5-compat-libs}} package. See [[#Segmentation fault on startup]] for more info.<br />
<br />
During the installation, you are asked if you want symlinks to be created. If you did not choose to do so, you can now manually create a symlink in {{ic|/usr/local/bin}} to make it easier to launch in terminal:<br />
<br />
# ln -s /{MATLAB}/bin/matlab /usr/local/bin<br />
<br />
Or you could add MATLAB install path to {{ic|PATH}} environment variable.<br />
<br />
==== Desktop entry ====<br />
<br />
Optionally create a [[desktop entry]]. The MIME type of MATLAB files is {{ic|text/x-matlab}}.<br />
<br />
Start {{ic|matlab}} with:<br />
<br />
* {{ic|-desktop}} to run Matlab without a terminal.<br />
* {{ic|-nosplash}} to prevent the splash screen from showing up.<br />
<br />
In order for icons to appear correctly {{ic|StartupWMClass}} needs to be set in the desktop entry. To find it out start MATLAB, run {{ic|xprop {{!}} grep WM_CLASS}} and select the MATLAB window.<br />
<br />
Example desktop entry (replace '''R2019a''' with your MATLAB version):<br />
<br />
{{hc|1=/usr/share/applications/matlab.desktop|<br />
2=[Desktop Entry]<br />
Version='''R2019a'''<br />
Type=Application<br />
Terminal=false<br />
MimeType=text/x-matlab<br />
Exec=/usr/local/MATLAB/'''R2019a'''/bin/matlab -desktop<br />
Name=MATLAB<br />
Icon=matlab<br />
Categories=Development;Math;Science<br />
Comment=Scientific computing environment<br />
StartupNotify=true<br />
}}<br />
<br />
If one need to set environment variable, one could prepend {{ic|env}} in {{ic|Exec}}, for example, to system's libfreetype:<br />
{{bc|<br />
<nowiki>Exec=env LD_PRELOAD=/usr/lib/libfreetype.so.6 matlab<br />
</nowiki><br />
}}<br />
<br />
One might wanna use system's {{ic|libstdc++}}.<br />
<br />
=== Installing from the AUR package ===<br />
<br />
The EULA for the proprietary MATLAB software is restrictive. The {{aur|matlab}} package from the [[AUR]] is designed to allow MATLAB to be integrated into and managed by Arch. The package should be built on the system on which it is going to be installed and the package should be deleted from the installation location and the [[Pacman]] cache following installation. Distributing the package is a clear violation of the EULA.<br />
<br />
The {{aur|matlab}} package from the [[AUR]] defaults to building a package for the most recent 64-bit release of MATLAB. Activation keys and installation files are required to be present in the package directory. There are detailed instructions on how to create the necessary files in the {{ic|README.md}}, provided alongside the PKGBUILD. (Due to needing local files; AUR helpers most likely cannot be used to build this package. Following the instructions and then building using {{ic|makepkg -sri}} is recommended.)<br />
<br />
One could also install older releases, eg. {{aur|matlab-r2015b}}. The method to create local files for older versions can be different; so it is best to refer to the PKGBUILD of interest. For example; the following is a set of instructions on how the installation files were generated for the 2019a version;<br />
<br />
* Download the zip file containing the MATLAB installer from Mathworks. Then, run the installer to download necessary files for installation.<br />
<br />
bsdtar xC matlab -f matlab_R2019a_glnxa64.zip<br />
./matlab/install<br />
<br />
* Make sure you check all the boxes of the toolboxes you would need, and wait until the download is finished. Make sure not to close the installer. You can locate the downloaded files:<br />
<br />
sudo find /tmp -name "tmw*"<br />
<br />
or<br />
<br />
cd /tmp<br />
ls | grep tmw<br />
<br />
* Merge the downloaded files to the installer:<br />
<br />
rsync -a /tmp/tmwXXXXXXXX/archives matlab<br />
<br />
* Then package the installer to the required tarball:<br />
<br />
tar -cvf matlab.tar -C matlab/ .<br />
<br />
* Then download the .lic file: Go in [https://mathworks.com/mwaccount/ your MathWorks account] and click on the license number you want to use. Then, go to the Install and Activate tab and select "Activate to Retrieve License File". Follow the instructions and download the license file needed for the installation and name the file <tt>matlab.lic</tt>. Also, the File Installation Key (FIK) is displayed: copy-paste it in a empty file and name it <tt>matlab.fik</tt>. <br />
<br />
* Copy the above files to the folder containing the PKGBUILD file. Then, modify the PKGBUILD file to install the toolboxes you need. Then, run the installation:<br />
<br />
makepkg -sri<br />
<br />
Depending on the versioning; this is how the files are to be generated.<br />
<br />
== Configuration ==<br />
<br />
=== Java ===<br />
<br />
The MATLAB software is bundled with a JVM and therefore it is not necessary to install [[Java]]. The JVM version supported by MATLAB is listed in [https://ww2.mathworks.cn/support/compilers.html System Requirements & Platform Availability] or simply type {{ic|version -java}} in MATLAB. One could set the {{ic|MATLAB_JAVA}} environment variable to use custom JVM, for example, to specify the {{pkg|jre8-openjdk}} JRE, launch MATLAB with:<br />
<br />
$ env MATLAB_JAVA=/usr/lib/jvm/java-8-openjdk/jre matlab<br />
<br />
=== OpenGL acceleration ===<br />
<br />
MATLAB can take advantage of hardware based 2D and 3D OpenGL acceleration. Support for hardware acceleration needs to be configured outside of MATLAB. Appropriate [[video drivers]] need to be installed along with the OpenGL utility library {{Pkg|glu}} package. If X11 forwarding is being used, the video drivers need to be installed on both the client and server. To check if MATLAB is making use of hardware based OpenGL acceleration run:<br />
<br />
$ matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If "software rendering" is not "false", then there is a problem with your hardware acceleration. If this is the case make sure OpenGL is configured correctly on the system. This can be done with the {{ic|glxinfo}} program from the {{Pkg|mesa-demos}} package:<br />
<br />
$ glxinfo | grep "direct rendering"<br />
<br />
If "direct rendering" is not "yes", then there is likely a problem with your system configuration.<br />
<br />
If glxinfo works but not matlab, you can try to run:<br />
$ export LD_PRELOAD=/usr/lib/libstdc++.so; export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/; matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If it works, you can edit Matlab launcher script to add:<br />
<br />
export LD_PRELOAD=/usr/lib/libstdc++.so<br />
export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/<br />
<br />
If you experience a low-level graphics error, you can use a software implementation of OpenGL or use an older driver. According to [[Intel graphics#Old OpenGL Driver (i965)|this]] entry in the ArchWiki, in Mesa 20.0 the new Iris driver was promoted to be the default for Gen8+. You may disable it and revert to use the old i965 driver by setting the {{ic|1=MESA_LOADER_DRIVER_OVERRIDE=i965}} [[environment variable]] before starting Matlab or any OpenGL application. Alternatively, you can run Matlab with the following command:<br />
<br />
$ env MESA_LOADER_DRIVER_OVERRIDE=i965 matlab -desktop<br />
<br />
If it works, you can edit the Matlab launcher script to add:<br />
<br />
export MESA_LOADER_DRIVER_OVERRIDE=i965<br />
<br />
=== Sound ===<br />
<br />
To confirm that MATLAB is able to use the default soundcard to present sounds run:<br />
<br />
$ matlab -nodesktop -nosplash -r "load handel; sound(y, Fs); pause(length(y)/Fs); exit" > /dev/null<br />
<br />
This should play an except from Handel's "Hallelujah Chorus." If this fails make sure [[ALSA]] is properly configured. This can be done with the {{ic|speaker-test}} program from the {{Pkg|alsa-utils}} package from the [[official repositories]]:<br />
<br />
$ speaker-test<br />
<br />
If you do not hear anything, then there is likely a problem with your system configuration.<br />
<br />
=== GPU computing ===<br />
<br />
MATLAB can take advantage of [http://www.mathworks.co.uk/discovery/matlab-gpu.html CUDA enabled GPUs] to speed up applications. In order to take advantage of a supported GPU install the {{Pkg|nvidia}}, {{Pkg|nvidia-utils}}, {{Pkg|ocl-icd}}, {{Pkg|opencl-nvidia}}, and {{Pkg|cuda}} packages from the [[official repositories]]. To check if MATLAB is able to utilize the GPU run:<br />
<br />
$ matlab -nodesktop -nosplash -r "x=rand(10, 'single'); g=gpuArray(x); Success=isequal(gather(g), x), exit" | sed -ne '/Success =/,$p'<br />
<br />
=== Install supported compilers ===<br />
<br />
In order to access the full functionality of MATLAB (e.g., to use Simulink, Builder JA, and MEX-file compilation), supported versions of the {{ic|gcc}}, {{ic|g++}}, {{ic|gfortran}}, and {{ic|jdk}} compilers must be installed. Details about the supported compilers for the [https://www.mathworks.com/support/compilers.html current release] and [https://www.mathworks.com/support/sysreq/previous_releases.html previous releases] are available online. Many of the supported {{ic|gcc}}, {{ic|g++}}, {{ic|jdk}} compiler versions for past MATLAB releases are available from the [[AUR]] (e.g., {{AUR|gcc43}}, {{AUR|gcc44}}, {{AUR|gcc47}}, {{AUR|gcc49}}and {{AUR|jdk6}}), while past versions of the {{ic|gfortran}} compilers are not packaged.<br />
<br />
To use previous versions of the the {{ic|gcc}}, {{ic|g++}}, and {{ic|gfortran}} compilers with MEX files, edit {{ic|${MATLAB}/bin/mexopts.sh}} and replace all occurrences of {{ic|<nowiki>CC='gcc'</nowiki>}} with {{ic|<nowiki>CC='gcc-4.X'</nowiki>}}, {{ic|<nowiki>CXX='g++'</nowiki>}} with {{ic|<nowiki>CXX='g++-4.X'</nowiki>}}, and {{ic|<nowiki>FC='gfortran'</nowiki>}} with {{ic|<nowiki>FC='gfortran-4.X'</nowiki>}}, where {{ic|X}} is the compiler version appropriate for the particular MATLAB release.<br />
<br />
{{Note|Newer versions of Matlab (at least 2017a) doesn't seem to respect the {{ic|${MATLAB}/bin/mexopts.sh}} customization. Instead it uses {{ic|${MATLAB}/bin/glnxa64/mexopts/LANG_glnxa64.xml}} file.}}<br />
<br />
{{Note|Though, it's no officially supported, one could still use higher version of compiler, and ignore the warnings.}}<br />
<br />
=== Help browser ===<br />
<br />
The help browser uses valuable slots in the dynamic thread vector and causes competition with core functionality provided by libraries like the BLAS that also depend on the dynamic thread vector. The help browser can be configured to use fewer slots in the dynamic thread vector with<br />
<br />
>> webutils.htmlrenderer('basic');<br />
<br />
This is a persistent change and to reverse it use<br />
<br />
>> webutils.htmlrenderer('default');<br />
<br />
=== Garbled Interface ===<br />
<br />
export J2D_D3D=false<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
=== Serial port access ===<br />
<br />
To successfully connect to any serial port, MATLAB expects to have write access directly to {{ic|/var/lock}} which is not allowed on Arch Linux for security reasons. Instead of allowing this access just for MATLAB, you can work around this problem by redirecting device locking using {{AUR|lockdev-redirect}}. All you have to do is executing MATLAB like this:<br />
<br />
# lockdev-redirect /{MATLAB}/bin/matlab<br />
<br />
If you've created a .desktop file as shortcut to MATLAB, then add "lockdev-redirect" as a prefix to your "Exec=" entry.<br />
<br />
=== HiDPI and 4k ===<br />
<br />
See [[HiDPI#MATLAB]]<br />
<br />
<br />
== Troubleshooting ==<br />
<br />
<br />
=== Blackscreen in help browser and livescripts ===<br />
<br />
In order to use help browser and livescripts install {{aur|libselinux}}.<br />
<br />
<br />
=== Static TLS errors ===<br />
<br />
MATLAB has a number of libraries that have been compiled with static thread local storage (TLS) including the help browser {{ic|doc}} and the BLAS libraries. For example,<br />
<br />
>> doc('help');<br />
>> ones(10)*randn(10);<br />
Error using * <br />
BLAS loading error:<br />
dlopen: cannot load any more object with static TLS<br />
<br />
is related to the bugs:<br />
<br />
* [http://www.mathworks.de/support/bugreports/961964 961964] for which patched libraries are available from [http://www.mathworks.de/support/bugreports/license/accept_license/5730?fname=attachment_961964_12b_13a_13b_14a_glnxa64_2014-01-30.zip&geck_id=961964 MathWorks]{{Dead link|2020|03|30|status=404}}<br />
* [http://www.mathworks.com/support/bugreports/1003952 1003952] for which workarounds exist<br />
<br />
A more general solution of recompiling {{ic|glibc}} has also been suggested. [https://stackoverflow.com/a/19468365]<br />
<br />
=== MATLAB crashes when displaying graphics ===<br />
<br />
To identify this error, start MATLAB with<br />
<br />
LIBGL_DEBUG=verbose matlab<br />
<br />
from the terminal and try to collect OpenGL information with {{ic|opengl info}} from the MATLAB command prompt. If it crashes again and there is an output line like <br />
<br />
libGL error: dlopen /usr/lib/xorg/modules/dri/swrast_dri.so failed <br />
(/usr/local/MATLAB/R2011b/bin/glnxa64/../../sys/os/glnxa64/libstdc++.so.6: <br />
version `GLIBCXX_3.4.15' not found (required by /usr/lib/xorg/modules/dri/swrast_dri.so))<br />
<br />
then the problem is that MATLAB uses its own GNU C++ library, which is an older version than the up-to-date version on your Archlinux system. Make MATLAB use the current C++ library for your system by<br />
<br />
cd /usr/local/MATLAB/R(your release)/sys/os/glnxa64<br />
sudo unlink libstdc++.so.6<br />
sudo ln -s /usr/lib/libstdc++.so.6<br />
<br />
If MATLAB still crashes or corrupts graphics (during startup or when plotting), make sure Java's 2D OpenGL rendering is disabled.<br />
The environment variable {{ic|_JAVA_OPTIONS}} should not contain {{ic|1=-Dsun.java2d.opengl=true}}.<br />
<br />
=== Blank/grey UI when using WM (non-reparenting window manager) ===<br />
<br />
This is a common issue in a number of window managers. (DWM, Awesome, bspwm) Java does not play well with these window managers. There are two methods.<br />
<br />
First try setting the environment variable by running<br />
<br />
$ export _JAVA_AWT_WM_NONREPARENTING=1<br />
<br />
If Matlab works afterwards, export the variable in your {{ic|.xinitrc}}.<br />
<br />
If it doesn't resolve, you have to fool Java into thinking the WM is named LG3D. (It's an old, depreciated WM that Java applications ironically support) Clean the previous environment variable, install the {{Pkg|wmname}} utility, and run.<br />
<br />
wmname LG3D<br />
<br />
Try running Matlab. If it works, put the fix in your starting script. ({{ic|.xinitrc}}, {{ic|bspwmrc}} and similar should be OK) Do note that other applications (such as {{ic|neofetch}}, or {{ic|tdrop}}) will think your WM is named LG3D, so you will have to configure them accordingly. Another solution is to run the command only before launching Matlab, and fixing the name after you are done with Matlab.<br />
<br />
If it doesn't work, try the combination of both. (The second line works in bspwm) If it still doesn't work, try googling similar issues with java in general.<br />
<br />
=== Garbled or invisible text ===<br />
<br />
Set the environment variable <code>J2D_D3D</code> to <code>false</code>[https://stackoverflow.com/questions/22737535/swing-rendering-appears-broken-in-jdk-1-8-correct-in-jdk-1-7].<br />
<br />
In newer versions of MATLAB (R2015b) [https://www.reddit.com/r/archlinux/comments/3yaga8/matlab_installer_bonked/] this also requires setting <code>MATLAB_JAVA</code> to something openjdk based. Example:<br />
<br />
export J2D_D3D=false<br />
./bin/glnxa64/install_unix -javadir /usr/lib/jvm/java-7-openjdk/jre<br />
<br />
=== Corrupted text and fonts in menus and fields ===<br />
If you notice that the menus or the input fields are corrupted or not appearing correctly then you can try to activate the ''"'''Use antialiasing to smooth desktop fonts'''"'' option in Matlab preferences, it seems to solve the problem. Go to '''''Preferences -> Matlab -> Fonts''''' and activate it. You will need to restart Matlab in order to take affect.<br />
<br />
=== Installation dependencies missing ===<br />
Matlab might complain that it cannot find a package. Look at the package name and install it with [[Pacman]], or in the case of x86_64 there are some libraries only in [[AUR]]. {{AUR|matlab}} and {{AUR|matlab-dummy}} packages contain a list of up-to-date dependencies for the newest Matlab version.<br />
<br />
If you get the following error when running the install script:<br />
<br />
terminate called after throwing an instance of 'std::runtime_error'<br />
what(): Unable to launch the MATLABWindow application<br />
Aborted<br />
<br />
this is solved by installing {{AUR|libselinux}} from the AUR.<br />
<br />
=== Installation error: archive is not a ZIP archive ===<br />
During the installation you can get:<br />
<br />
The following error was detected while installing ''package_name'': archive is not a ZIP archive <br />
Would you like to retry installing ''package_name''? If you press No, the installer will exit without completing the installation. More information can be found at /tmp/mathworks_root.log<br />
<br />
Matlab downloads all packages to {{ic|/tmp/}} directory which resides in RAM and is maximum size of half of available memory. In this case it is not enough for installation files and Matlab 2019a installer will warn you about this. If it did not, or if you ignored the warning, you will have got the above error.<br />
<br />
You can either [[Tmpfs#Examples|resize tmpfs]] (3,5 GB is not enough, 6 GB works), or remove packages from base install and add them later with built-in Matlab add-on installer.<br />
<br />
=== Install-time library errors ===<br />
* Make sure that the symlink {{ic|bin/glnx64/libstdc++.so.6}} is pointing to the correct version of {{ic|libstdc++.so.xx}} (which is also in the same directory and has numbers where 'xx' is). By default, it may be pointing to an older (and nonexistent) version (different value for 'xx').<br />
<br />
* Make sure the device you're installing from is not mounted as {{ic|noexec}}<br />
<br />
* If you downloaded the files from Mathworks' website, make sure they are not on an NTFS or FAT partition, because that can mess up the symlinks. Ext4 or Ext3 should work.<br />
<br />
=== Resolving start warnings/errors ===<br />
<br />
* Even if all needed libraries are installed, Matlab when starting can still report some missing libraries. This is resolved by symbolic linking of needed libraries to directories that Matlab checks at start-up. For example, if Matlab triggers error/warning about missing {{ic|/lib64/libc.so.6}} library, this can be resolved by:<br />
<br />
# ln -s /lib/libc.so.6 /lib64<br />
<br />
* Matlab R2011b with an up-to-date Arch Linux (as of March 12, 2012) fails on startup with the familiar "Failure loading desktop class." A solution is to point Matlab to the system JVM (confirmed to work with the {{Pkg|jdk7-openjdk}} package):<br />
<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
* Matlab R2017b with an up-to-date Arch Linux (as of September 30, 2017) fails on startup with the familiar "Failure loading desktop class." A solution is to install outdated versions of the libraries in the packages {{Pkg|cairo}} (1.14.10 works) and {{Pkg|harfbuzz}} (1.4.6 works) to a local directory and add them to the LD_LIBRARY_PATH for matlab (See also: [https://bbs.archlinux.org/viewtopic.php?id=228944]): <br />
<br />
LD_LIBRARY_PATH="/opt/matlab/outdatedLibraries/:$LD_LIBRARY_PATH" /opt/matlab/R2017b/bin/matlab<br />
<br />
=== Segmentation fault on startup ===<br />
<br />
If Matlab (R2016a or earlier) stops working after upgrading {{Pkg|ncurses}} to v6.x, [[install]] the {{AUR|ncurses5-compat-libs}} package. See [https://bbs.archlinux.org/viewtopic.php?id=202575 BBS#202575].<br />
<br />
In newer versions (e.g. R2017b), the issue could also be due to a font display failing to load.<br />
Try moving the libfreetype.so.6 font display file in $MATLAB/bin/glnxa64/ to an 'exclude' directory; see [https://bbs.archlinux.org/viewtopic.php?id=231299 BBS#231299].<br />
<br />
ncurses compatibility layer is not required anymore for R2018a.<br />
<br />
=== Hangs on rendering or exiting with Intel graphics ===<br />
<br />
Some users have reported issues with DRI3 enabled on Intel Graphics chips. A possible workaround is to disable DRI3 and run MATLAB with hardware rendering on DRI2; to do so, launch MATLAB with the environment variable LIBGL_DRI3_DISABLE set to 1:<br />
<br />
LIBGL_DRI3_DISABLE=1 /{MATLAB}/bin/matlab<br />
<br />
If the previous workaround does not work, the issue can be circumvented by selecting software rendering with the MATLAB command (beware, performance may be very poor when doing e.g. big or complex 3D plots):<br />
<br />
opengl('save','software')<br />
<br />
See [https://bugzilla.redhat.com/show_bug.cgi?id=1357571] and [https://bugs.freedesktop.org/show_bug.cgi?id=96671] for more.<br />
<br />
=== Addon manager not working ===<br />
This section is relevant for both R2017b and R2018a.<br />
<br />
Addon manager requires the {{AUR|libselinux}} package to work.<br />
<br />
Since upgrade from pango-1.40.5 to pango-1.40.6, the MATLABWindow application (responsible for Add-On Manager, Simulation Data Inspector and perhaps something else) cannot be started. {{Bug|54257}}<br />
A workaround is to point MATLAB shipping glib libraries to those glib libraries from your system. There are 5 of those libraries in {{ic|matlabroot/R2017b/cefclient/sys/os/glnxa64}}, namely, as of R2017b:<br />
<br />
libgio-2.0.so<br />
libglib-2.0.so<br />
libgmodule-2.0.so<br />
libgobject-2.0.so<br />
libgthread-2.0.so<br />
<br />
Make it so that these symlinks are pointing to your system glib libraries instead of versions located in {{ic|matlabroot/R2017b/cefclient/sys/os/glnxa64}}.<br />
On a standard arch install the local files reside in {{ic|/usr/lib/}}.<br />
<br />
Do not forget to update the {{ic|*.0}} links as well.<br />
<br />
Relinking of "libfreetype.so.6" is also necessary to open these interfaces. This is found in {{ic|matlabroot/R2017b/bin/glnxa64/}}.<br />
<br />
If the window opens but is blank, consider switching the html renderer to: " webutils.htmlrenderer('basic');" as described in [[#Help browser]].<br />
<br />
=== Live Script Errors ===<br />
If you get the error when attempting to load or create a LiveScript:<br />
{{ic|Viewing matlab live script files is not currently supported by this operating system configuration}}<br />
*It could be because of broken symlinks of {{Pkg|libgcrypt}} and other dependencies, after system updates. On the first start of the Live Editor the components are extracted and these libary symlinks are created (if not existing).<br />
<br />
A solution is to simply delete the whole folder containing the broken symlinks and the extracted components, which are in the installation directory (represented by {{ic|$MATLABROOT}}) under:<br />
$MATLABROOT/sys/jxbrowser-chromium<br />
Or if the installation directory is not user writable in:<br />
~/.matlab/R2017b/HtmlPanel<br />
Matlab will then regenerate the contents on the next Live Editor start.<br />
<br />
A better option is to replace libgcrypt symlink in this extraction directory with a less precise one. For example, after extraction, this link to /lib64/libgcrypt.so.20.2.4 is created. Replace it with e.g. /lib64/libgcrypt.so.20.<br />
<br />
Matlab R2020 does not contain a chromium directory anymore. Relinking the library file libcrypto.so.1.1 with the system file can resolve the issue. It is located in:<br />
$MATLABROOT/bin/glnxa64<br />
<br />
*Also the steps in [[#Addon manager not working]] may resolve the issue.<br />
*It can also happen due to missing gconf package. Make sure {{AUR|gconf}} is installed.<br />
*If the above does not help, execute in the command window<br />
>> com.mathworks.mde.liveeditor.widget.rtc.CachedLightweightBrowserFactory.createLightweightBrowser()<br />
to get a more detailed error message.<br />
* A debugging console can be opened with<br />
>> com.mathworks.mde.webbrowser.HtmlPanelDebugConsole.invoke;<br />
<br />
=== Using webcam/video device ===<br />
Make sure the correct support package addons are installed (webcam or OS Generic Video Interface for example). If running matlab as a user, make sure your user has write permissions to wherever the support packages are being downloaded and installed.<br />
<br />
At least Matlab 2016b doesn't recognize webcams or imaq adapters correctly without gstreamer0.10. The gstreamer0.10 can be found in the aur and installed as a work around.<br />
<br />
Since MATLAB R2017a, Image Acqusition Toolbox is using GStreamer library version 1.0. It previously used version 0.10.<br />
<br />
In general, USB Webcam Support Package does a better job working with UVC and built-in cameras than OS Generic Video Interface Support Package.<br />
<br />
{{Warning|As of 2018-08-15 updating gst from 1.14.0 to 1.14.2 breaks video device operation (MATLAB doesn't see the video device anymore). Downgrading fixes this.}}<br />
<br />
=== MATLAB hangs for several minutes when closing Help Browser ===<br />
Since upgrade of glibc from 2.24 to 2.25, MATLAB (at least R2017a) hangs when closing Help Browser. The issue is related to the particular version of jxbrowser-chromium shipped with MATLAB.<br />
This issue is still present with glibc 2.26 and MATLAB R2017b and R2018a.<br />
<br />
To fix this issue, download the [https://www.teamdev.com/jxbrowser latest jxbrowser] and replace the following jars from MATLAB:<br />
<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-chromium.jar<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-linux64.jar<br />
<br />
MATLAB should automatically unpack those jars into {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} when first opening Help Browser.<br />
Remove {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} directory to make sure MATLAB uses the latest jxbrowser.<br />
<br />
Unfortunately, this workaround doesn't work in R2017b anymore. Going deeper into investigation of this issue, it is related to a crash of one of jxbrowser-chromium processes. The parent process of jxbrowser-chromium then sits there and waits for response from a process that is already dead. This causes MATLAB main window to freeze. You can easily unfreeze MATLAB by manually killing all leftover jxbrowser-chromium processes.<br />
<br />
I've come up with this simple script that uses inotify and waits for user to close Help browser in MATLAB. It triggers when user closes Help browser and sends kill signal to all leftover jxbrowser-chromium processes:<br />
<br />
#!/usr/bin/bash<br />
<br />
if [ -z "$1" ]; then<br />
REL=R2017b<br />
else<br />
REL=$1<br />
fi<br />
<br />
JXPATH="/path/to/MATLAB/$REL/sys/jxbrowser-chromium/glnxa64/chromium"<br />
CMD="inotifywait -m -e CLOSE $JXPATH/resources.pak"<br />
<br />
#Exit if the daemon is already active<br />
if ! pgrep -f "$CMD" > /dev/null; then<br />
#Wait for user to close Help Browser, then killall leftover jxbrowser processes<br />
$CMD |<br />
while read line<br />
do<br />
killall "$JXPATH/jxbrowser-chromium"<br />
done<br />
else<br />
exit<br />
fi<br />
<br />
I run this script as part of my MATLAB start script like that:<br />
~/bin/unfreeze_matlab.sh R2017b &<br />
<br />
To make sure that this background job is killed when I exit MATLAB, I use this in the beginning of MATLAB start script:<br />
trap "trap - SIGTERM && kill -- -$$" SIGINT SIGTERM EXIT<br />
<br />
=== Some dropdown menus cannot be selected ===<br />
In some interfaces - such as Simulation Data Inspector or Simulink Test Manager - nothing happens when choosing an item in dropdown menu (for example, when trying to change a number of subplots in Simulation Data Inspector). To work around this issue, hold down the Shift key while clicking the item in dropdown menu.<br />
<br />
=== Not starting - licensing error===<br />
In case MATLAB will not start from a [[desktop environment]] by the call of its [[desktop file]] one should see the output as you start it from the terminal.<br />
<br />
For a ''Licensing error'' such as:<br />
<br />
{{hc<br />
|# matlab|<br />
MATLAB is selecting SOFTWARE OPENGL rendering.<br />
License checkout failed.<br />
License Manager Error -9<br />
This error may occur when: <br />
-The hostid of this computer does not match the hostid in the license file. <br />
-A Designated Computer installation is in use by another user. <br />
If no other user is currently running MATLAB, you may need to activate.<br />
<br />
Troubleshoot this issue by visiting: <br />
http://www.mathworks.com/support/lme/R2017a/9<br />
<br />
Diagnostic Information:<br />
Feature: MATLAB <br />
License path: /home/<USER>/.matlab/R2017a_licenses/license_<NUM>_R2017a.lic:/home/<USER>/.matlab/R2017a_licenses/lice<br />
nse_Darkness_<NUM>_R2017a.lic:/opt/MATLAB/R2017a/licenses/license.dat:/opt/MATLAB/R2017a/licenses/*<br />
.lic <br />
Licensing error: -9,57.<br />
}}<br />
<br />
A re-activation might solve the problem.<br />
<br />
=== MATLAB crashes with "Failure loading desktop class" on startup ===<br />
In case MATLAB won't start and starting it from command line gives you the following error:<br />
{{hc<br />
|$ matlab|<br />
Fatal Internal Error: Internal Error: Failure occurs during desktop startup. Details: Failure loading desktop class.<br />
}}<br />
and you have the option [[Java#GTK_LookAndFeel|{{ic|1=-Dswing.defaultlaf=com.sun.java.swing.plaf.gtk.GTKLookAndFeel}}]] set in your {{ic|_JAVA_OPTIONS}} environment variable, start MATLAB with<br />
<br />
$ _JAVA_OPTIONS= matlab<br />
<br />
If this works, add the line<br />
<br />
export _JAVA_OPTIONS=<br />
<br />
to your MATLAB launcher script. Optionally re-add other Java options.<br />
<br />
=== Unable to type in text fields of interfaces based on MATLABWindow ===<br />
Since R2018a, it is not possible to type text in interfaces based on MATLABWindow - like Signal Editor, Add-Ons Explorer and others.<br />
MATLABWindow and MATLAB's webwindow infrastructure is based on Chromium Embedded Framework, and it looks like a known and long standing bug: https://bitbucket.org/chromiumembedded/cef/issues/2026/multiple-major-keyboard-focus-issues-on<br />
<br />
One possible workaround is to switch focus from the MATLABWindow to another window and then switch back - so that you can type.<br />
<br />
To elaborate more on this workaround (since the problem is still there in R2018b), here is what i did in my Openbox config (note that the A-Middle keybinding already exist in default config):<br />
<br />
<mousebind button="A-Middle" action="Press"><br />
<action name="Unfocus"/><br />
<action name="Focus"/><br />
</mousebind><br />
<br />
Now, whenever it is not possible to type in a text field, I press Alt+Mouse middle mouse and then I can type again.<br />
<br />
This problem is critical during installation. After one clicks some elements in the installation window, he will not be able to type into any textbox anymore and switching between windows does not always work. To circumvent the issue, one shall only use key-press, instead of mouse click during installation. MATLAB installer has a poor support on Wayland, one may also consider using other WM instead during installation.<br />
<br />
=== Installer crashes with "Unable to launch the MATLABWindow application" ===<br />
In MATLAB version R2020a Update 5 (and possibly older), the installer crashes before the splash in shown.<br />
{{hc<br />
|$ ./install |<br />
terminate called after throwing an instance of 'std::runtime_error'<br />
what(): Unable to launch the MATLABWindow application<br />
Aborted (core dumped)<br />
}}<br />
<br />
The problem is solved by removing (or hiding) the {{ic|libgl*}} libraries of the MATLAB installer, as suggested for an older issue [https://it.mathworks.com/matlabcentral/answers/397138-why-do-i-get-a-matlabwindow-application-failed-to-launch-error-when-launching-live-editor-app-des#answer_316968]<br />
<br />
$ cd matlab_R2020a_glnxa64/cefclient/sys/os/glnxa64/<br />
$ mkdir exclude<br />
$ mv libglib-2.0.so* exclude/<br />
<br />
=== Add-on manager does not start in R2020a ===<br />
<br />
In MATLAB version R2020a Update 5 (and possibly older), the Add-on manager does not start. Instead, the following error is shown<br />
<br />
Error using matlab.internal.cef.webwindow (line 385)<br />
MATLABWindow application failed to launch. Unable to launch the MATLABWindow application<br />
<br />
Error in matlab.internal.webwindow/createImplementation (line 288)<br />
implObj = matlab.internal.cef.webwindow(varargin{:});<br />
<br />
Error in matlab.internal.webwindow (line 144)<br />
obj.impl = obj.createImplementation(varargin{:});<br />
<br />
Error in matlab.internal.addons.AddOnsWindow/launch (line 51)<br />
obj.webwindow = matlab.internal.webwindow(char(url), obj.debugPort, obj.normalWindowPosition);<br />
<br />
Error in matlab.internal.addons.Explorer/loadUrlForNavigateToMessage (line 125)<br />
obj.addOnsWindowInstance.launch(url, obj.windowStateUtil.getExplorerWindowMaximizedSetting);<br />
<br />
Error in matlab.internal.addons.Explorer/show (line 56)<br />
obj.loadUrlForNavigateToMessage(url);<br />
<br />
Error in matlab.internal.addons.launchers.showExplorer (line 128)<br />
matlab.internal.addons.Explorer.getInstance.show(navigationData);<br />
<br />
The problem is solved by removing (or hiding) the {{ic|libgl*}} and {{ic|libgio*}} libraries of MATLAB, as suggested for an older issue [https://it.mathworks.com/matlabcentral/answers/397138-why-do-i-get-a-matlabwindow-application-failed-to-launch-error-when-launching-live-editor-app-des#answer_316968]<br />
<br />
$ cd {MATLAB INSALLATION FOLDER}/cefclient/sys/os/glnxa64/<br />
$ mkdir exclude<br />
$ mv libglib-2.0.so* libgio-2.0.so* exclude/<br />
<br />
<br />
=== Cannot verify university login during installation ===<br />
<br />
For total headcount license users, MATLAB will pop-up a window asking the user to login with his credentials in a web browser. However, if run with {{ic|sudo}}, most browsers (especially chromium) will not run. To circumvent this problem, one shall 'active the computer' through MATLAB's website using a browser by a normal user. [https://www.mathworks.com/matlabcentral/answers/326647-verify-university-login-not-open-browser See this issue]<br />
<br />
== Matlab in a systemd-nspawn ==<br />
Matlab can be run within a systemd-nspawn container to maintain a static system and avoid the library issues that often plague matlab installs after significant updates to libraries in Arch. Refer to [[Systemd-nspawn]] for detailed information on setting up such containers.<br />
<br />
The following lists instruction to get a MATLAB 2017b install running in a minimal debian 9 environment. It assumes matlab is already installed as normal in "/usr/local/MATLAB/R2017b". <br />
<br />
Use [[Xhost]] to allow the nspawn environment to use the existing X server instance, see also [[Systemd-nspawn#Use an X environment]].<br />
<br />
Create a minimal debian environment in a folder ("deb9" here) with:<br />
<br />
$ debootstrap --arch=amd64 stretch deb9<br />
<br />
Set a password for the root user and then boot the environment with:<br />
<br />
$ systemd-nspawn --bind-ro=/dev/dri --bind=/tmp/.X11-unix --bind=/usr/local/MATLAB/ -b -D deb9<br />
<br />
Install the following packages to have the requisite libraries in the nspawn environment for MATLAB. "mesa-utils" and "usbutils" can be installed to debug graphics acceleration and usb interfaces for I/O with MATLAB.<br />
<br />
$ apt-get install xorg build-essential libgtk2.0-0 libnss3 libasound2 <br />
<br />
Install the MATLAB-support (from contrib source) package in the environment for some convenient integration. <br />
<br />
$ apt-get install matlab-support<br />
<br />
Set the $DISPLAY variable to use your existing X server instance.<br />
<br />
$ export DISPLAY=:0<br />
<br />
MATLAB can be launched from within the environment normally by using the binary at $MATLABROOT/bin.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=607425ASUS ROG GL702ZC2020-04-23T18:00:40Z<p>Bbaserdem: /* Fans */ Merged this part with the suggested page.</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{Pkg|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module for backlight is {{ic|amdgpu_bl0}}. (Keyboard LED's are interfaced with {{ic|asus::kbd_backlight}}) {{Pkg|light}} works well, and available in the repos. (The default should be the screen backlight) For example; the following commands will increase/decrease backlight of the screen;<br />
<br />
$ light -A 5<br />
$ light -U i<br />
<br />
For controlling the keyboard LEDS using the same command; the target must be defined;<br />
<br />
$ light -Ars "sysfs/leds/asus::kbd_backlight" 1<br />
$ light -Urs "sysfs/leds/asus::kbd_backlight" 1<br />
<br />
== Fans ==<br />
<br />
{{pkg|lm_sensors}} do not detect any interfaces for fan control. However, fan control through [[Fan speed control#NBFC|NBFC]] works well; and there is a profile for this laptop. Enabling and starting the service files, and applying the configurations are sufficient.<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ===<br />
<br />
The BIOS has an utility to load your own BIOS keys; however loading my own keys in the BIOS using the firmware interface did not work.<br />
<br />
=== Fans turn 100% and computer becomes unresponsive after long idle time ===<br />
<br />
Haven't found a fix for this, but reporting this issue nonetheless.<br />
<br />
=== Crashes with MCE ===<br />
<br />
The system will sometimes crash (check the [https://www.phoronix.com/forums/forum/hardware/general-hardware/961327-asus-rog-strix-gl702zc/page12 Phoronix thread]). The problem seems to be the AMD processor. There is no suggested fix other than RMA; you can check if you are affected by running [https://github.com/suaefar/ryzen-test/blob/master/kill-ryzen.sh ryzen kill script]. My personal experience is that I have two cores that cause these errors; and I had not have it happen much after configuring fans using {{ic|nbfc}}.<br />
<br />
To further investigate, check out [[Machine-check exception]]<br />
<br />
=== Bluetooth and network issues ===<br />
<br />
The wifi card is of model {{ic|rtl8822be}}. Older kernel versions don't have the bluetooth module for this card (>4.19). Also, on 5.2; the rtl cards wifi modules were merged into {{ic|rtlwifi}}; which was not working for a while. (See my BBS thread [https://bbs.archlinux.org/viewtopic.php?id=247711 here]) Currently, wifi works with the stable kernel; but is noticeably slower than the previous kernel module.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=607421ASUS ROG GL702ZC2020-04-23T17:09:09Z<p>Bbaserdem: As the original author; I have been making tweaks into this laptop. I changed the solutions to some of the problems; and offered better alternative solutions to others.</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{Pkg|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module for backlight is {{ic|amdgpu_bl0}}. (Keyboard LED's are interfaced with {{ic|asus::kbd_backlight}}) {{Pkg|light}} works well, and available in the repos. (The default should be the screen backlight) For example; the following commands will increase/decrease backlight of the screen;<br />
<br />
$ light -A 5<br />
$ light -U i<br />
<br />
For controlling the keyboard LEDS using the same command; the target must be defined;<br />
<br />
$ light -Ars "sysfs/leds/asus::kbd_backlight" 1<br />
$ light -Urs "sysfs/leds/asus::kbd_backlight" 1<br />
<br />
== Fans ==<br />
<br />
{{pkg|lm_sensors}} do not detect any interfaces for fan control. However, fan control through {{AUR|nbfc}} (master branch available as {{AUR|nbfc-git}}) works well; and there is a profile for this laptop. Enabling and starting the service files, and applying the configurations are sufficient.<br />
<br />
# systemctl enable --now nbfc.service<br />
# systemctl enable --now nbfc-sleep.service<br />
# nbfc config --apply 'Asus ROG GL702ZC'<br />
<br />
Check the status of the service; currently there is a [https://github.com/hirschmann/nbfc/issues/439 bug with nbfc]. Potential fixes include;<br />
<br />
* Renaming/removing the offending dll. ({{ic|mv '/opt/nbfc/Plugins/StagWare.Plugins.ECSysLinux.dll' '/opt/nbfc/Plugins/StagWare.Plugins.ECSysLinux.dll.bak'}})<br />
* Adding the kernel parameter {{ic|1=ec_sys.write_support=1}}.<br />
<br />
For more info; check [[Fan speed control#NBFC|NBFC]].<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ===<br />
<br />
The BIOS has an utility to load your own BIOS keys; however loading my own keys in the BIOS using the firmware interface did not work.<br />
<br />
=== Fans turn 100% and computer becomes unresponsive after long idle time ===<br />
<br />
Haven't found a fix for this, but reporting this issue nonetheless.<br />
<br />
=== Crashes with MCE ===<br />
<br />
The system will sometimes crash (check the [https://www.phoronix.com/forums/forum/hardware/general-hardware/961327-asus-rog-strix-gl702zc/page12 Phoronix thread]). The problem seems to be the AMD processor. There is no suggested fix other than RMA; you can check if you are affected by running [https://github.com/suaefar/ryzen-test/blob/master/kill-ryzen.sh ryzen kill script]. My personal experience is that I have two cores that cause these errors; and I had not have it happen much after configuring fans using {{ic|nbfc}}.<br />
<br />
To further investigate, check out [[Machine-check exception]]<br />
<br />
=== Bluetooth and network issues ===<br />
<br />
The wifi card is of model {{ic|rtl8822be}}. Older kernel versions don't have the bluetooth module for this card (>4.19). Also, on 5.2; the rtl cards wifi modules were merged into {{ic|rtlwifi}}; which was not working for a while. (See my BBS thread [https://bbs.archlinux.org/viewtopic.php?id=247711 here]) Currently, wifi works with the stable kernel; but is noticeably slower than the previous kernel module.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=LightDM&diff=554398LightDM2018-11-10T16:33:48Z<p>Bbaserdem: /* Optional configuration and tweaks */ I included information about Xsession wrapper that was missing.</p>
<hr />
<div>[[Category:Display managers]]<br />
[[Category:Canonical]]<br />
[[es:LightDM]]<br />
[[fr:LightDM]]<br />
[[ja:LightDM]]<br />
[[ru:LightDM]]<br />
[[zh-hans:LightDM]]<br />
{{Related articles start}}<br />
{{Related|Display manager}}<br />
{{Related|GDM}}<br />
{{Related|LXDM}}<br />
{{Related articles end}}<br />
<br />
[http://www.freedesktop.org/wiki/Software/LightDM LightDM] is a cross-desktop [[display manager]]. Its key features are:<br />
* Cross-desktop - supports different desktop technologies.<br />
* Supports different display technologies (X, Mir, Wayland ...).<br />
* Lightweight - low memory usage and high performance.<br />
* Supports guest sessions.<br />
* Supports remote login (incoming - XDMCP, VNC, outgoing - XDMCP, pluggable).<br />
* Comprehensive test suite.<br />
* Low code complexity.<br />
<br />
More details about LightDM's design can be found [http://www.freedesktop.org/wiki/Software/LightDM/Design here].<br />
<br />
== Installation ==<br />
<br />
[[Install]] the {{Pkg|lightdm}} package.<br />
{{Tip|Stable releases are even-numbered (1.8, 1.10) while development releases are odd-numbered (1.9, 1.11). These development releases are available with {{AUR|lightdm-devel}}. Also available is {{AUR|lightdm-git}}.}}<br />
<br />
=== Greeter===<br />
<br />
You will probably want to install a greeter. A greeter is a GUI that prompts the user for credentials, lets the user select a session, and so on. It is possible to use LightDM without a greeter, but only if an automatic login is configured, otherwise you will need to install {{pkg|xorg-server}} and one of the greeter packages below.<br />
<br />
The official repositories contain the following greeters:<br />
* {{Pkg|lightdm-gtk-greeter}}: this is the '''default''' greeter LightDM attempts to use when started unless configured to do otherwise.<br />
* lightdm-deepin-greeter ({{Pkg|deepin-session-ui}}): A greeter from the [[Deepin]] project.<br />
<br />
Other alternative greeters are available in the [[AUR]]:<br />
* {{AUR|lightdm-slick-greeter}}: A GTK+ Based greeter that is preferred over the {{Pkg|lightdm-gtk-greeter}} by distro creators<br />
* {{Pkg|lightdm-webkit2-greeter}}: A greeter that uses Webkit2 for theming. It supersedes {{AUR|lightdm-webkit-greeter}}.<br />
* {{AUR|lightdm-unity-greeter}}: The greeter used by Ubuntu's [[Unity]].<br />
* {{AUR|lightdm-pantheon-greeter}}: A greeter from the elementary OS project.<br />
* {{AUR|lightdm-mini-greeter}}: A minimal, configurable, single-user greeter.<br />
<br />
You can set the default greeter by changing the {{ic|[Seat:*]}} section of the LightDM configuration file, like so:<br />
<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
[Seat:*]<br />
...<br />
greeter-session=lightdm-''yourgreeter''-greeter<br />
...<br />
}}<br />
<br />
One way to check which greeters are available is to list the files in the {{ic|/usr/share/xgreeters}} directory; each ''.desktop'' file represents an available greeter. In this example, the {{ic|lightdm-gtk-greeter}} and {{ic|lightdm-kde-greeter}} greeters are available:<br />
$ ls -1 /usr/share/xgreeters/<br />
lightdm-gtk-greeter.desktop<br />
lightdm-kde-greeter.desktop<br />
<br />
== Enabling LightDM ==<br />
<br />
Make sure to [[enable]] {{ic|lightdm.service}} so LightDM will be started at boot, see also [[Display manager#Loading the display manager]].<br />
<br />
== Command line tool ==<br />
<br />
LightDM offers a command line tool, {{ic|dm-tool}}, which can be used to lock the current seat, switch sessions, etc, which is useful with 'minimalist' window managers and for testing. To see a list of available commands, execute:<br />
$ dm-tool --help<br />
<br />
=== User switching ===<br />
<br />
{{Accuracy|Is this warning inappropriate? Don't {{ic|dm-tool lock}} and {{ic|dm-tool switch-to-greeter}} do the equivalent of calling {{ic|loginctl lock-session}}? If your screen locker doesn't register with ''logind'' then there's nothing {{ic|dm-tool ...}} can do - but that's not LightDM's fault. This issue is well known and touched upon [[List_of_applications#Screen_lockers|here]] and [[XScreenSaver#Lock_on_suspend|here]].}}<br />
<br />
{{Warning|1=The use of lightDM's built-in screen lockers like {{ic|dm-tool lock}} or {{ic|dm-tool switch-to-greeter}} are [https://bbs.archlinux.org/viewtopic.php?pid=1712213#p1712213 '''not''' recommended]. Use [[#Lock the screen using light-locker|light-locker]] or something from [[List of applications/Security#Screen lockers]].}}<br />
<br />
LightDM's ''dm-tool'' command can be used to allow multiple users to be logged in on separate ttys. The following will send a signal requesting that the current session be locked and then will initiate a switch to LightDM's greeter, allowing a new user to log in to the system.<br />
<br />
$ dm-tool switch-to-greeter<br />
<br />
== Testing ==<br />
<br />
First, [[install]] {{Pkg|xorg-server-xephyr}} from the [[official repositories]].<br />
<br />
Then, run LightDM as an X application:<br />
$ lightdm --test-mode --debug<br />
<br />
== Optional configuration and tweaks ==<br />
<br />
LightDM can be configured by modifying its config file, {{ic|/etc/lightdm/lightdm.conf}}.<br />
<br />
Some greeters have their own configuration files. For example:<br />
<br />
{{Pkg|lightdm-gtk-greeter}}: {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}}<br />
<br />
{{Pkg|lightdm-webkit2-greeter}}: {{ic|/etc/lightdm/lightdm-webkit2-greeter.conf}}<br />
<br />
{{Pkg|lightdm-kde-greeter}}{{Broken package link|package not found}}: {{ic|/etc/lightdm/lightdm-kde-greeter.conf}}<br />
<br />
=== X session wrapper ===<br />
<br />
If you are migrating from [[xinit]], you will notice that the display is not launched by your shell. This is because, as opposed to your shell starting the display (and the display inheriting the environment of your shell), LightDM starts your display and does not source your shell. LightDM launches the display by running a wrapper script and that finally exec's your graphic environment. By default, {{ic|/etc/lightdm/Xsessions.conf}} is run.<br />
<br />
==== Environment variables ====<br />
<br />
The script checks and sources {{ic|/etc/profile}}, {{ic|~/.profile}}, {{ic|/etc/xprofile}} and {{ic|~/.xprofile}}, in that order. If you are using a shell that does not source any of these files, you can create an {{ic|~/.xprofile}} to do so. (In this example, the login shell is [[zsh]])<br />
<br />
{{hc|~/.xprofile|2=<br />
#!/bin/sh<br />
<nowiki>[[ -f ~/.config/zsh/.zshenv ]] && source ~/.config/zsh/.zshenv</nowiki><br />
}}<br />
<br />
If you have shell variables that are important for your display (such as Gtk or QT themes, GNUPG location, config overrides, etc.) this will let your graphic environment have access to your environment without having to be launched by your login shell.<br />
<br />
==== Keymap ====<br />
<br />
The script runs [[Xkbmap]] with arguments provided in files {{ic|/etc/X11/Xkbmap}}, {{ic|~/.Xkbmap}}. If those files are not found, it runs [[xmodmap]] with {{ic|/etc/X11/Xmodmap}}, {{ic|~/.Xmodmap}}. If using xkbmap, the files are parsed using cat. The following example works<br />
<br />
{{hc|~/.xprofile|2=<br />
-model pc105 -layout us,us,tr -variant ,dvorak,f -option grp:caps_toggle<br />
}}<br />
<br />
=== Changing background images/colors ===<br />
<br />
You can set the background to a hex color or an image. Some greeters offer more robust background options like background selection from the login screen, random backgrounds, etc.<br />
<br />
==== GTK+ greeter ====<br />
<br />
You can use the {{Pkg|lightdm-gtk-greeter-settings}} gui.<br />
<br />
Users wishing to customize the wallpaper on the greeter screen need to edit {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} and define the {{ic|background}} variable under the {{ic|[greeter]}} section. For example:<br />
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|2=<br />
[greeter]<br />
background=/usr/share/pixmaps/black_and_white_photography-wallpaper-1920x1080.jpg<br />
}}<br />
<br />
{{Note|It is recommended to place the PNG or JPG file in {{ic|/usr/share/pixmaps}} since the LightDM user needs read access to the wallpaper file.}}<br />
<br />
===== GTK3 Theme =====<br />
GTK3 themes can be specified with the {{ic|theme-name}} variable in the {{ic|[greeter]}} section of {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} For example, {{ic|1=theme-name=Adwaita-dark}}.<br />
<br />
==== Webkit2 greeter ====<br />
<br />
The {{Pkg|lightdm-webkit2-greeter}} allows you to choose a background image directly on the login screen. It also offers an option to display a random image each time it starts if you use the [https://github.com/artur9010/lightdm-webkit-material Material theme]. By default, images are sourced from {{ic|/usr/share/backgrounds}}. You can change the background images directory by editing {{ic|lightdm-webkit2-greeter.conf}}. For example:<br />
{{hc|/etc/lightdm/lightdm-webkit2-greeter.conf|2=<br />
[branding]<br />
background_images = /usr/share/backgrounds<br />
}}<br />
<br />
{{Note|The background images directory must be accessible to the LightDM user so it should not be located anywhere under {{ic|/home}}. }}<br />
<br />
==== Unity greeter ====<br />
<br />
Users using the {{AUR|lightdm-unity-greeter}} must edit the {{ic|/usr/share/glib-2.0/schemas/com.canonical.unity-greeter.gschema.xml}} file and then execute:<br />
# glib-compile-schemas /usr/share/glib-2.0/schemas/<br />
<br />
According to [https://bbs.archlinux.org/viewtopic.php?id=149945 this] page.<br />
<br />
==== KDE greeter ====<br />
<br />
Go to ''System Settings > Login Screen (LightDM)'' and change the background image for your theme.<br />
<br />
Alternatively, you can edit the {{ic|Background}} variable in {{ic|lightdm-kde-greeter.conf}} :<br />
<br />
{{hc|/etc/lightdm/lightdm-kde-greeter.conf|2=<br />
[greeter]<br />
theme-name=classic<br />
<br />
[greeter-settings]<br />
Background=/usr/share/archlinux/wallpaper/archlinux-underground.jpg<br />
BackgroundKeepAspectRatio=true<br />
GreetMessage=Welcome to %hostname%<br />
}}<br />
<br />
==== Slick Greeter ====<br />
<br />
Use the {{AUR|lightdm-settings}} GUI <br />
<br />
=== Changing your avatar ===<br />
<br />
{{Tip|If you are using KDE, you can change your avatar in KDE System Settings.}}<br />
<br />
First, make sure the {{Pkg|accountsservice}} package from the [[official repositories]] is installed, then set it up as follows, replacing {{ic|''username''}} with the desired user's login name.<br />
<br />
* Create the file {{ic|/var/lib/AccountsService/icons/''username''.png}} using a 96x96 PNG image file. Different image file formats are possible too, e.g., JPEG.<br />
<br />
* Edit or create the account settings file {{ic|/var/lib/AccountsService/users/''username''}}, and add the lines<br />
<br />
[User]<br />
Icon=/var/lib/AccountsService/icons/''username''.png<br />
<br />
The filename here should point to the icon created in the first step, so adjust the filename extension if necessary.<br />
<br />
{{Note|Make sure that both created files have 644 permissions, use [[chmod]] to correct them.}}<br />
<br />
=== Sources of Arch-centric 64x64 icons ===<br />
<br />
The {{AUR|archlinux-artwork}} package contains some nice examples that install to {{ic|/usr/share/archlinux/icons}} and that can be copied to {{ic|/usr/share/icons/hicolor/64x64/devices}} as follows:<br />
<br />
# find /usr/share/archlinux/icons -name "*64*" -exec cp {} /usr/share/icons/hicolor/64x64/devices \;<br />
<br />
After copying, the {{AUR|archlinux-artwork}} package can be removed.<br />
<br />
=== Enabling autologin ===<br />
<br />
Edit the LightDM configuration file and ensure these lines are uncommented and correctly configured:<br />
<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
[Seat:*]<br />
autologin-user=''username''<br />
}}<br />
<br />
You must be part of the {{ic|autologin}} group to be able to login automatically without entering your password:<br />
<br />
# groupadd -r autologin<br />
# gpasswd -a ''username'' autologin<br />
<br />
LightDM logs in using the session specified in the {{ic|~/.dmrc}} of the user getting logged in automatically. To override this file, specify {{ic|autologin-session}} in {{ic|lightdm.conf}}:<br />
<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
[Seat:*]<br />
autologin-user=''username''<br />
autologin-session=''session''<br />
}}<br />
<br />
You will also need to ensure you have the {{Pkg|accountsservice}} package installed, otherwise LightDM will fail to start, and running it from the command line will show {{ic|Error getting user list from org.freedesktop.Accounts}}.<br />
<br />
{{Note|GNOME users, and by extension any gnome-keyring user will have to set up a blank password to their keyring for it to be unlocked automatically.}}<br />
<br />
=== Enabling interactive passwordless login ===<br />
<br />
LightDM goes through PAM so you must configure the lightdm configuration of PAM:<br />
<br />
{{hc|/etc/pam.d/lightdm|2=<br />
#%PAM-1.0<br />
'''auth sufficient pam_succeed_if.so user ingroup nopasswdlogin'''<br />
auth include system-login<br />
...<br />
}}<br />
<br />
You must then also be part of the {{ic|nopasswdlogin}} group to be able to login interactively without entering your password:<br />
<br />
# groupadd -r nopasswdlogin<br />
# gpasswd -a ''username'' nopasswdlogin<br />
<br />
{{Note|GNOME users, and by extension any gnome-keyring user may have to follow the instructions at the end of the previous section on enabling autologin.}}<br />
<br />
To create a new user account that logs in automatically and additionally able to login again without a password the user can be created with supplementary membership of both groups, e.g.:<br />
<br />
# useradd -mG autologin,nopasswdlogin -s /bin/bash ''username''<br />
<br />
=== Hiding system and services users ===<br />
To prevent system users from showing-up in the login, install the optional dependency {{Pkg|accountsservice}}, or add the user names to {{ic|/etc/lightdm/users.conf}} under {{ic|hidden-users}}. The first option has the advantage of not needing to update the list when more users are added or removed.<br />
<br />
=== Migrating from SLiM ===<br />
<br />
{{Merge|Display Manager|Not LightDM specific (or even SLiM specific for that matter as [[XDM]] also uses [[xinitrc]]). Perhaps this merits a one-liner somewhere on the [[Display Manager]] page?}}<br />
<br />
Move the contents of [[xinitrc]] to [[xprofile]], removing the call to start the [[window manager]] or [[desktop environment]].<br />
<br />
=== Login using ~/.xinitrc ===<br />
<br />
See [[Display manager#Run ~/.xinitrc as a session]].<br />
<br />
=== NumLock on by default ===<br />
<br />
Install the {{Pkg|numlockx}} package and then edit {{ic|/etc/lightdm/lightdm.conf}}:<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
[Seat:*]<br />
greeter-setup-script=/usr/bin/numlockx on<br />
}}<br />
<br />
=== Default session ===<br />
<br />
Lightdm, like other DMs, stores the last-selected xsession in {{ic|~/.dmrc}}. See [[Display manager#Session configuration]] for more info.<br />
<br />
=== Adjusting the login window's position ===<br />
<br />
==== GTK+ greeter ====<br />
<br />
Users need to edit {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} and enter a value for the {{ic|position}} variable. It accepts {{ic|x}} and {{ic|y}} values, either absolute (in pixels) or relative (in percent). Each value can also have an additional anchor location for the window, {{ic|start}}, {{ic|center}} and {{ic|end}} separated from the value by a comma.<br />
<br />
Example:<br />
<br />
position=200,start 50%,center<br />
<br />
=== VNC Server ===<br />
Lightdm can also be used to connect to via VNC. Make sure to install {{pkg|tigervnc}} on the server side and optionally as your VNC client on the client PC.<br />
<br />
Setup an authentication password on the server as root:<br />
<br />
# vncpasswd /etc/vncpasswd<br />
<br />
Edit the LightDM configuration file as shown below. Note that {{ic|listen-address}} configures the VNC to only listen to connections from localhost. This is used to only allow connections via [[TigerVNC#On_the_client|SSH and port forwarding]]. On the SSH client, make sure that you use {{ic|localhost:5900}} for the tunnel destination; using {{ic|127.0.0.1:5900}} or {{ic|::1:5900}} is not reliable on dual stack network connections. If you want to allow insecure connections you can disable this setting.<br />
<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
[VNCServer]<br />
enabled=true<br />
command=Xvnc -rfbauth /etc/vncpasswd<br />
port=5900<br />
listen-address=localhost<br />
width=1024<br />
height=768<br />
depth=24<br />
}}<br />
<br />
Now open an SSH tunnel and connect to localhost as described in [[TigerVNC#On the client]].<br />
<br />
{{Note|If you get a blank screen upon opening the VNC connection, try a different LightDM greeter.}}<br />
<br />
=== Lock the screen using light-locker ===<br />
{{Pkg|light-locker}} is a simple screen locker using LightDM to authenticate the user. Once it is installed and running you can lock your session using<br />
$ light-locker-command -l<br />
This requires {{ic|light-locker}} to be started at the beginning of your session - see [[Autostarting]].<br />
<br />
== Troubleshooting ==<br />
If you encounter consistent screen flashing and ultimately no LightDM on boot, ensure that you have defined the greeter correctly in LightDM's config file. And if you have correctly defined the GTK greeter, make sure the {{ic|xsessions-directory}} (default: {{ic|/usr/share/xsessions}}) exists and contains at least one .desktop file.<br />
<br />
The same error can happen on lightdm startup if the last used session is not available anymore (eg. you last used gnome and then removed the gnome-session package): the easiest workaround is to temporarily restore the removed package. Another solution might be:<br />
<br />
# dbus-send --system --type=method_call --print-reply --dest=org.freedesktop.Accounts /org/freedesktop/Accounts/User1000 org.freedesktop.Accounts.User.SetXSession string:xfce<br />
<br />
This example sets the session "xfce" as default for the user 1000.<br />
<br />
=== Wrong locale displayed ===<br />
<br />
In case of your locale not being displayed correctly in Lightdm add your locale to {{ic|/etc/environment}}<br />
LANG=pt_PT.utf8<br />
<br />
Alternatively if you want LightDM and its greeters to be in a language other than your set system locale, you can use the {{ic|1=Environment=}} option in [[Systemd#Drop-in files]].<br />
<br />
=== Missing icons with GTK greeter ===<br />
<br />
If you are using {{Pkg|lightdm-gtk-greeter}} as a greeter and it shows placeholder images as icons, make sure valid icon themes and themes are installed and configured. Check the following file:<br />
<br />
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|2=<br />
[greeter]<br />
theme-name=mate # this should be the name of a directory under /usr/share/themes/<br />
icon-theme-name=mate # this should be the name of a fully featured icons set directory under /usr/share/icons/<br />
}}<br />
<br />
=== LightDM freezes on login attempt ===<br />
<br />
You may find that after entering the correct username and password and attempting to log in, LightDM freezes and you are unable to continue to the desktop. To fix the issue, reinstall the {{Pkg|gdk-pixbuf2}} package. See [https://bbs.archlinux.org/viewtopic.php?id=179031 this forum thread].<br />
<br />
=== LightDM displaying in wrong monitor ===<br />
<br />
If you are using multiple monitors, LightDM may display in the wrong one (e.g. if your primary monitor is on the right). To force the LightDM login screen to display on a specific monitor, edit {{ic|/etc/lightdm/lightdm.conf}} and change the ''display-setup-script'' parameter like this:<br />
{{hc|/etc/lightdm/lightdm.conf|2=<br />
display-setup-script=xrandr --output ''HDMI1'' --primary<br />
}}<br />
<br />
Replace ''HDMI1'' with your real monitor ID, which you can find from '''xrandr''' command output.<br />
<br />
Alternatively, if you are using the GTK+ greeter, you can edit {{ic|/etc/lightdm/lightdm-gtk-greeter.conf}} and add the ''active-monitor'' parameter like this:<br />
{{hc|/etc/lightdm/lightdm-gtk-greeter.conf|2=<br />
[greeter]<br />
active-monitor=0<br />
}}<br />
<br />
Replace 0 with the desired display number.<br />
<br />
=== LightDM does not appear or monitor only displays TTY output===<br />
<br />
It may happen that your system boots so fast that LightDM service is started before your graphics drivers are properly loaded. If this is your case, you will want to add the following config to your lightdm.conf file:<br />
<br />
[LightDM]<br />
logind-check-graphical=true<br />
<br />
This setting will tell LightDM to wait until graphics devices are ready before spawning greeters/autostarting sessions on them.<br />
<br />
=== Pulseaudio not starting automatically ===<br />
<br />
See [[PulseAudio#Running]].<br />
<br />
=== Long pause before LightDM shows up when home is encrypted ===<br />
<br />
Some LightDM themes try to access the user avatar located in HOME. If your HOME is encrypted, LightDM cannot access it and hangs. To prevent this from happening, you can either:<br />
<br />
* Set your avatar as explained in [[#Changing your avatar]]<br />
* for {{Pkg|lightdm-gtk-greeter}} only: {{Ic|<nowiki>hide-user-image = true</nowiki>}} in {{Ic|/etc/lightdm/lightdm-gtk-greeter.conf}}<br />
<br />
=== Boot hangs on "[ OK ] Reached target Graphical Interface." ===<br />
<br />
There is a possibility that user and group lookups fail if you modified /etc/nsswitch.conf. That happens when:<br />
<br />
* nsswitch.conf group: includes {{Ic|<nowiki>ldap</nowiki>}} without setting {{Ic|<nowiki>nss_initgroups_ignoreusers ALLLOCAL</nowiki>}} in {{Ic|<nowiki>/etc/nslcd.conf</nowiki>}}<br />
<br />
== See also ==<br />
<br />
* [https://wiki.ubuntu.com/LightDM Ubuntu Wiki article]<br />
* [http://wiki.gentoo.org/wiki/LightDM Gentoo Wiki article]<br />
* [https://launchpad.net/lightdm Launchpad Page] obsolete<br />
* [http://www.mattfischer.com/blog/?tag=lightdm LightDM blog]<br />
* [https://github.com/CanonicalLtd/lightdm LightDM on GitHub]</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=Pantheon&diff=553307Pantheon2018-11-06T04:23:11Z<p>Bbaserdem: /* Installation */ Added some recent info why some packages are missing, and hints on how to compile from AUR</p>
<hr />
<div>[[Category:Desktop environments]]<br />
[[ja:Pantheon]]<br />
[[pl:Pantheon]]<br />
[[zh-hans:Pantheon]]<br />
[https://bbs.archlinux.org/viewtopic.php?id=152930 Pantheon] is the desktop environment originally created for the [http://elementary.io/ elementary OS] distribution. It is written from scratch in [[Wikipedia:Vala (programming language)|Vala]], using [[GTK+|GTK3]] and [https://github.com/elementary/granite Granite]. With regards to usability and appearance, the desktop has some similarities with [[GNOME Shell]] and [[Wikipedia:MacOS|macOS]].<br />
<br />
== Project Status ==<br />
<br />
Although the [https://elementary.io/ elementary OS] release schedule and toolchain are bound to [[Arch_compared_to_other_distributions#Ubuntu|Ubuntu's]] LTS release cycle, [https://plus.google.com/communities/104613975513761463450 development] moves quickly and has recently moved to [https://github.com/elementary github].<br />
<br />
== Installation ==<br />
<br />
=== Packages ===<br />
<br />
==== Unofficial repository ====<br />
<br />
Alucryd's unofficial repository contains more and more [https://github.com/alucryd/aur-alucryd/tree/master/pantheon up-to-date] packages than the few available in the [[community repository]]. To use it add the following lines at the top of your sources in {{Ic|/etc/pacman.conf}}:<br />
{{bc|<nowiki><br />
[extra-alucryd]<br />
Server = https://pkgbuild.com/~alucryd/$repo/$arch<br />
</nowiki>}}<br />
Do note that some packages are missing from the repository due to [https://github.com/alucryd/aur-alucryd/issues/88#issuecomment-434606676 issues] with upstream. You will have to supplement the repo with locally compiled packages.<br />
<br />
==== AUR ====<br />
<br />
Alternatively, the [[PKGBUILD]]s for the pantheon packages are also available in the [[AUR]].<br />
<br />
As of writing, {{AUR|gala-git}} will fail to build with the current version of {{Pkg|mutter}}, and will require a [[Downgrading_packages|downgrade]] to the latest compatible version (3.28). (This is the reason why some packages are missing from the [https://github.com/alucryd/aur-alucryd/tree/master/pantheon unofficial repo].) You can either downgrade, package {{Pkg|mutter}} 3.28 separately (do consider submitting to AUR if you do), or wait until upstream decides to adapt the most recent version. {{AUR|gala-git}} is a dependency for a lot of packages; you need to take care of this for a lot of the applications.<br />
<br />
=== Desktop Environment ===<br />
<br />
For the minimal Pantheon shell, install {{AUR|pantheon-session-git}}, which pulls--among other dependencies--the core components:<br />
* {{AUR|cerbere-git}}: Watchdog service; restarts core components if they crash.<br />
* {{AUR|gala-git}}: Window and composting manager <br />
* {{AUR|wingpanel-git}}: Top panel (holds the launcher, clock, and indicators)<br />
* {{AUR|pantheon-applications-menu-git}}: Application launcher formerly known as "Slingshot"<br />
* {{Pkg|plank}}: macOS-style Dock<br />
<br />
=== Services and Configuration ===<br />
<br />
These optional packages provide background services and default settings for Pantheon and elementary OS applications:<br />
* {{AUR|pantheon-default-settings-git}}: Default appearance, behavior, and configuration; pulls in theme packages {{Pkg|elementary-icon-theme}}, {{AUR|gtk-theme-elementary-git}}, and {{AUR|elementary-wallpapers-git}}<br />
* {{AUR|gnome-settings-daemon-elementary}}: A patched {{AUR|gnome-settings-daemon-ubuntu}} required by {{AUR|pantheon-dpms-helper-git}} and {{AUR|wingpanel-indicator-power-git}}<br />
* {{AUR|pantheon-print-git}}: Print settings dialog<br />
* {{AUR|pantheon-polkit-agent-git}}: Polkit authentication agent<br />
<br />
=== Theme ===<br />
<br />
These optional packages contribute to the look and feel of the desktop:<br />
* {{Pkg|elementary-icon-theme}} or {{AUR|elementary-icon-theme-git}}: Icon theme designed to be smooth, sexy, clear, and efficient<br />
* {{AUR|lightdm-pantheon-greeter}} or {{AUR|lightdm-pantheon-greeter-git}}: LightDM greeter<br />
It is also recommended to install the following fonts:<br />
* {{AUR|ttf-opensans}}: Open Sans Fonts<br />
* {{AUR|ttf-raleway}}: Raleway Font<br />
* {{Pkg|ttf-dejavu}}: Font family based on the Bitstream Vera Fonts<br />
* {{Pkg|ttf-droid}}: General-purpose fonts released by Google as part of Android<br />
* {{Pkg|ttf-freefont}}: Set of free outline fonts covering the Unicode character set<br />
* {{Pkg|ttf-liberation}}: Red Hats Liberation fonts<br />
<br />
=== Applications ===<br />
<br />
These are some of the original, patched, and selected packages that comprise the optional elementary OS software suite:<br />
* {{Pkg|pantheon-files}} or {{AUR|pantheon-files-git}}: File explorer developed from Marlin<br />
* {{Pkg|pantheon-terminal}} or {{AUR|pantheon-terminal-git}}: Terminal emulator<br />
* {{Pkg|pantheon-code}} or {{AUR|pantheon-code-git}}: Text editor formerly known as "Scratch"<br />
* {{AUR|pantheon-calculator}} or {{AUR|pantheon-calculator-git}}: Calculator<br />
* {{Pkg|pantheon-music}} or {{AUR|pantheon-music-git}}: Audio player formerly known as "Noise"<br />
* {{Pkg|pantheon-videos}} or {{AUR|pantheon-videos-git}}: Video player formerly known as "Audience"<br />
* {{AUR|pantheon-calendar-git}}: Calendar application formerly known as "Maya", integrates with {{AUR|wingpanel-indicator-datetime-git}}<br />
* {{AUR|epiphany-pantheon}}: Web browser replacing {{AUR|midori-granite}}<br />
* {{AUR|pantheon-mail-git}}: Email client developed from {{Pkg|geary}}<br />
* {{AUR|pantheon-screenshot}} or {{AUR|pantheon-screenshot-git}}: Screenshot tool<br />
* {{AUR|eidete-bzr}}: Simple screencaster<br />
* {{Pkg|pantheon-photos}} or {{AUR|pantheon-photos-git}}: Photo manager developed from {{Pkg|shotwell}}<br />
* {{AUR|pantheon-camera-git}}: Webcam app developed from {{AUR|snap-photobooth}}<br />
* {{AUR|elementary-scan-bzr}}: Simple scan utility (does not build)<br />
* {{AUR|switchboard}} or {{AUR|switchboard-git}}: Pluggable settings manager similar to {{Pkg|gnome-control-center}}<br />
<br />
== Launching Pantheon ==<br />
<br />
=== Via [[Display manager]] ===<br />
<br />
{{AUR|pantheon-session-git}} provides a {{Pkg|gnome-session}} entry for display managers such as {{Pkg|gdm}} or {{Pkg|lightdm}}.<br />
<br />
==== Autostart applications with a display manager ====<br />
<br />
As a gnome-session, Pantheon implements [[GNOME#Autostart|XDG Autostart]].<br />
<br />
=== Via [[xinit]] ===<br />
<br />
Alternatively, you can use {{Ic|~/.xinitrc}} to launch the Pantheon shell, by adding {{ic|exec cerbere}} to the end of the file.<br />
<br />
==== Autostart applications with ''xinit'' ====<br />
<br />
For applications which do not provide a [[Systemd#Using_units|systemd unit]], consider these options:<br />
<br />
* Run once when X starts:<br />
:Add it to your [[#Via_xinit|{{Ic|~/.xinitrc}}]] [[Shell]] script, before the {{ic|exec cerbere}} line.<br />
<br />
* Keep running in the background:<br />
:Add it to the [[#Configuration|dconf key]] {{Ic|org.pantheon.desktop.cerbere.monitored-processes}}.<br />
:Should the process stop, {{AUR|cerbere}} will respawn it.<br />
<br />
* Launch from a [[.desktop]] file:<br />
:Use a program like {{AUR|dapper}}, {{AUR|dex-git}}, or {{AUR|fbautostart}} to implement [[XDG Autostart]].<br />
<br />
==Configuration==<br />
<br />
Configure Pantheon via {{AUR|switchboard}} or {{AUR|switchboard-git}} and its plugs (''switchboard-plug-*''), which must be installed separately. Not all of {{Pkg|gnome-control-center}}'s settings panels have been ported. In addition, except [[plank]], all the Pantheon components store their configuration in the {{Ic|org.pantheon}} or {{Ic|io.elementary}} [[GNOME#Configuration|gsettings keys]], which can be edited with {{Pkg|dconf-editor}}.<br />
<br />
{{Note|{{AUR|switchboard-plug-elementary-tweaks-git}} provides easy access to [https://raw.githubusercontent.com/elementary-tweaks/elementary-tweaks/master/docs/screenshot.png customizations for various aspects of the Pantheon desktop and applications], similar to {{Pkg|gnome-tweaks}}.}}<br />
<br />
=== Wingpanel ===<br />
<br />
Wingpanel does not come with any indicators; they must be installed separately.<br />
<br />
At the minimum, you'll probably want to install:<br />
* {{AUR|slingshot-launcher}} or {{AUR|pantheon-applications-menu-git}}: Applications menu and "Run" dialog<br />
* {{AUR|wingpanel-indicator-datetime}} or {{AUR|wingpanel-indicator-datetime-git}}: Clock and calendar widget<br />
* {{AUR|wingpanel-indicator-session}} or {{AUR|wingpanel-indicator-session-git}}: User and session menu (Switch user, Logout, Shutdown, etc.)<br />
<br />
{{Note|{{AUR|wingpanel}} supports [[Unity|Ayatana indicators]], while {{AUR|wingpanel-git}} has native indicators (''wingpanel-indicator-*-git'').}}<br />
<br />
==== Third-party indicators ====<br />
<br />
* If launched by a [[#Via Display manager|display manager]], append {{Ic|Pantheon;}} to {{ic|1=OnlyShowIn=}} in third-party indicators' [[XDG_Autostart|*.desktop files]]<br />
<br />
* If launched by [[#Via xinit|~/.xinitrc]], add third-party indicators to one of the start-up methods described [[#Launching Pantheon|above]].<br />
<br />
* [[Unity|Ayatana Indicators]] require {{AUR|wingpanel-indicator-ayatana}} or {{AUR|wingpanel-indicator-ayatana-git}} to appear in {{AUR|wingpanel-git}}.<br />
<br />
==== Indicator-session menus unresponsive ====<br />
<br />
* {{AUR|indicator-session}} relies on dbus methods provided by [[Unity]] for most of its functions and fails to fallback to gnome or systemd methods in its absence.<br />
<br />
* {{AUR|wingpanel-indicator-session-git}} needs [[light-locker]] or {{AUR|xscreensaver-dbus-screenlock}} installed for the {{Ic|Lock}} menu item.<br />
<br />
=== Plank ===<br />
<br />
==== Adding new application icons ====<br />
<br />
Either drag and drop a desktop file on to the dock, or right click on a running application and select "Keep in dock". You can then reorder icons by drag and drop.<br />
{{Note|Plank stores .dockitem launchers in {{ic|~/.config/plank/}} and configuration in the gsettings key {{ic|net.launchpad.plank}}}}<br />
<br />
=== Pantheon Files ===<br />
<br />
==== Enable context menu entries ====<br />
<br />
If you want to enable context menu entries such as for {{Pkg|file-roller}} to extract/compress archives, then you have to additionally install {{Pkg|contractor}} or {{AUR|contractor-git}}.<br />
<br />
=== Terminal ===<br />
<br />
====Opacity====<br />
<br />
To make {{Pkg|pantheon-terminal}} (semi-)transparent, [[#Configuration|set the dconf key]] {{ic|org.pantheon.terminal.settings.opacity}} to your desired opacity; for {{AUR|pantheon-terminal-git}}, the background color and transparency are set by {{ic|io.elementary.terminal.settings.background}}.<br />
<br />
== Known Issues ==<br />
<br />
=== Appearance ===<br />
<br />
==== Pantheon-terminal transparency ====<br />
<br />
Transparency in pantheon-terminal is not yet fully functional with GTK themes other than the elmentary OS theme. Either use {{AUR|gtk-theme-elementary}}, {{AUR|gtk-theme-elementary-git}} or add the following code to your theme's css or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}:<br />
/************<br />
* Terminal *<br />
***********/<br />
<br />
PantheonTerminalPantheonTerminalWindow.background {<br />
background-color: transparent;<br />
}<br />
<br />
==== Wingpanel transparency ====<br />
<br />
Wingpanel is transparent by design when using {{AUR|gtk-theme-elementary}} or {{AUR|gtk-theme-elementary-git}}, and becomes opaque when a maximized window occupies your screen. However, using other GTK themes will produce a solid panel most of the time.<br />
<br />
To achieve the former behavior within another theme, add the following code to its css or the override file in {{ic|~/.config/gtk-3.0/gtk.css}}:<br />
<br />
/*********************<br />
* wingpanel support *<br />
********************/<br />
<br />
.panel {<br />
background-color: transparent;<br />
transition: all 1s ease-in-out;<br />
}<br />
<br />
.panel.maximized {<br />
background-color: #000;<br />
}</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=535291ASUS ROG GL702ZC2018-08-15T17:42:53Z<p>Bbaserdem: /* Troubleshooting */ Added bluetooth issues</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} and {{ic|input}} group. (Default udev rules override for kbd_backlight, so you can't set them to video as well) {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Fans don't have OS control, and handled by ACPI. Upshot is works out of the box, downside is can't configure them.<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ===<br />
<br />
The BIOS has an utility to load your own BIOS keys, which was glitching for my FAT32 formatted USB drive. Tried using keytool, which bricked the computer. I suggest further work into this.<br />
<br />
=== Fans turn 100% and computer becomes unresponsive after long idle time ===<br />
<br />
Haven't found a fix for this, but reporting this issue nontheless.<br />
<br />
=== Bluetooth device not found ===<br />
<br />
A patch has been applied for the bluetooth controller, that will prob roll in the 4.18 kernel. See this forum thread; https://bbs.archlinux.org/viewtopic.php?id=234603</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=535289ASUS ROG GL702ZC2018-08-15T17:40:53Z<p>Bbaserdem: /* Backlight */ Changed the fix</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} and {{ic|input}} group. (Default udev rules override for kbd_backlight, so you can't set them to video as well) {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Fans don't have OS control, and handled by ACPI. Upshot is works out of the box, downside is can't configure them.<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ===<br />
<br />
The BIOS has an utility to load your own BIOS keys, which was glitching for my FAT32 formatted USB drive. Tried using keytool, which bricked the computer. I suggest further work into this.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=Laptop/ASUS&diff=529840Laptop/ASUS2018-07-15T20:12:41Z<p>Bbaserdem: /* Model List */ fixed ASUS GL702ZC bluetooth misinformation</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ノートパソコン/Asus]]<br />
{{Laptops navigation}}<br />
<br />
== Model List ==<br />
<br />
{| class="wikitable sortable"<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! colspan="8" |Hardware support <br />
! class="unsortable" rowspan=2 | Remarks<br />
|-<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
<br />
|-<br />
| ASUS VivoBook 14 X442UA-GA139T || 2018.05.01 || Intel UHD Graphics 620 (Kabylake GT2) || works ok (haven't check everything) || Works || not tested in archiso, works well with NetworkManager || Untested || est ~7hrs, unverifed || untested || grep bugs /proc/cupinfo = bugs: cpu_meltdown spectre_v1 spectre_v2 spec_store_bypass<br />
|| UEFI secure boot doesn't pass, might need work.<br />
|-<br />
|-<br />
| [[ASUS GL702ZC]] (ROG Strix AMD) || 2017.04.01 || Radeon RX580 - Kernel AMDGPU driver works great. || Pulseaudio works well. (Did not test HDMI audio autput) || Works || Archiso couldn't connect to wireless, but no problems afterwards || Doesn't work (4.17.5-1) || Haven't tested [[TLP]] benefits. Notably bad battery life; about 1 hour on standby. || untested || Wireless doesn't work in Debian branch kernels. Backlight keys are amdgpu, not xbacklight. Fancontrol is ACPI, there are some amdgpu fan control stuff on aur/github but haven't tested yet.<br />
|-<br />
|-<br />
| ASUS GL552VM-DM-802D || 2017.02.01 || GTX960m - need nvidia proprietary driver with specific boot kernel otherwise due to a kernel lockup, you won't be able to boot. '''acpi_osi=! acpi_osi='Windows 2009'''' || works out of the box using pulseaudio || works out of the box || works out of the box || not tested || still testing || not tested || || need to add acpi_backlight=native to have fn keys backlight control and idle=nomwait<br />
|-<br />
|-<br />
| ASUS G502VM-FY017T || 2017.02.01 || GTX1060 3G - i use nvidia proprietaries driver it work fine after done an "mhwd-kernel -i linux410 & reboot" , nouveau not tested || works out of the box using pulseaudio (KDE stock) || works out of the box || works out of the box || works out the box (and using a Bluetooh headset like a Bose Qc35 works fine after a little workaround) || ~3.75hrs in normal use, with decent screen brightness, seems the same as what IÂ get on Windows 10 || not tested || Most Fn keys, sound control, works out the box, but the screen ajustment need a little workaround and it's fine|| Do ''not'' install intel drivers. This laptop does not have integrated graphics. <br />
|-<br />
| FX502VM || 2017.02.01 || GTX1060 3G - install nvidia, nouveau does not work || works out of the box using pulseaudio || works out of the box with r8169 || works out of the box || not tested || ~3hrs in normal use, with decent screen brightness || not tested || Fn keys does not send ACPI events, except F10,F11,F12 (sound control) || Do ''not'' install intel drivers. This laptop does not have integrated graphics.<br />
|-<br />
| [[ASUS Zenbook UX305|UX305FA]] || 2016.10.01 || Intel HD 5300 - install {{pkg|xf86-video-intel}} || works out of the box in [[GNOME]], [[i3]] works with pulseaudio || Intel - works out of the box || 802.11 ac module, works out of the box || works out of the box in [[GNOME]] || around 4 hours of battery life under decent load, gets quite hot, but never throttles || webcam works || Function keys for brightness (F5/F6) don't send ACPI events, F3 and F4 do, however. <br />
|-<br />
| K55N || 2014.11.12 || Radeon HD 7520G - install {{pkg|xf86-video-ati}} || snd,snd_hda_codec works out of the box using pulseaudio || r8169 module, out of the box || ath9k module, out of the box || not present|| Overheats and immediately shuts down on modern 3D games. Use thermald to control temp using acpi_cpufreq || webcam works || Fix fn brightness keys with "acpi_osi="!Windows 2012" video.use_native_backlight=1". Don't enable early radeon hook to prevent blank screen after hibernation. Fix blank screen on suspend to ram with "sysctl -w kernel.acpi_video_flags=3". <br />
|-<br />
| X401U || 2014.01.05 || Radeon HD 7340 - install {{pkg|xf86-video-ati}} || did not work out of the box, never configured correctly, using pulse, everything works || not tested || Wi-Fi out of the box || none to support|| all power options work just fine || webcam works || overall performance is satisfactory<br />
|-<br />
| X401A/X401A1 || 2013.05.01 || Integrated Intel HD Graphics - install {{pkg|xf86-video-intel}} and {{pkg|libva-intel-driver}}, enable SNA || hda-intel works, headphone jack, mic works || Realtek, out of the box || Wi-Fi out of the box || not tested || all power options work just fine, only brightness control needs module asus-nb-wmi to be loaded and {{ic|1=acpi_backlight=intel acpi_osi=}} [[GRUB]] options as of kernel 3.9.4 || webcam works || overall performance is satisfactory<br />
|-<br />
| W7S || Don't Panic || 3D with NVIDIA drivers || hda-intel || r8169 module, out of the box || Intel 4965 works with iwlwifi || works out of the box || || webcam works with uvc drivers, but it is mounted upside down || ACPI works with acpi4asus and acpid<br />
|-<br />
| N80Vn-X5 || 2009.02RC2 || 3D with NVIDIA drivers || hda-intel plus adding {{ic|1=options snd-hda-intel enable=1 model=g50v position_fix=0}} to {{ic|/etc/modprobe.d/modprobe.conf}} || Out of box with r8169 module || out of box with ath9k || out of box || || webcam and card reader both work out of the box || ACPI works fine with the {{ic|asus_laptop}} module<br />
|-<br />
| F8SN || 2009.08 || only tried with open source NV drivers (got 1280x800 pixels default without xorg edit), 3D proprietary will probably work || hda-intel || Ethernet works out of the box || Intel 4965 works with iwlwifi || untested-but is recognized by kernel || untested-battery status can be detected and customization options exist || Syntek Sonic web cam and Ricoh Card reader work out of the box (might need to allow user mount privileges just as you would for other ext. drives) || Highly compatible with Arch Linux<br />
|-<br />
| L3000D || Most recent as of 2010-02-13 || Works out of box || Works out of box || Works out of box || Not contains || Not contains || Works perfectly || Untested || <br />
|-<br />
| [[ASUS N53JN|N53JN]] || Most recent as of 2010-11-03 || Contains NVIDIA Optimus, so only Intel graphic card works. Waiting for NVIDIA to support Optimus on Linux || Works, needs some editing of modprobe files || Works out of box || ath9k || Untested || Hibernate untested, suspend works but with problems due to USB3 controller || Web cam works, touchpad works, media buttons work ||<br />
|-<br />
| N53SV || Most recent as of 2011-06-26 || Contains NVIDIA Optimus, so only Intel graphic card works.|| hda-intel || r8169 module, works out of box || ath9k needs madwifi || Untested || [https://bbs.archlinux.org/viewtopic.php?pid=910195 BBS thread] || Web cam works, touchpad works, card reader works. See also [https://help.ubuntu.com/community/Asus_N53 Ubuntu help]||<br />
|-<br />
| A8Le || Most recent as of 2011-07-31 || Works out of box || Works out of box (with [[ALSA]], 'Speaker' channel should be un-muted) || Out of box with r8169 module || Untested || Untested || Untested|| Touchpad works ||<br />
|-<br />
| 1005HA || 2011.08.19 || Works out of box using i915 || hda-intel || Works out of box || ath9k || Untested || Untested || ||<br />
|-<br />
| 1015E || 2014.05.19 || Works out of box using i915 || hda-intel || Works out of the box. || Wifi out of the box. || Untested || Display brightness and toggle, battery management, power, lid close works out of the box. Suspend works out of the box. Hibernate works after following instructions [[Suspend and hibernate#Hibernation|here]]. || Touchpad requires {{pkg|xf86-input-synaptics}} package. Webcam/mic works. Card reader works. USB 3.0 untested. || Overall satisfactory. {{pkg|efibootmgr}} v0.12 doesn't work, and v0.11 is recommended. {{pkg|linux}} kernel v4.3 and v4.4 has kswapd0 bug. {{pkg|linux-lts}} is recommended until fixed. Only display, audio and sleep fn keys are recognized.<br />
|-<br />
| [[ASUS UL30A|UL30A]] || 2011.08.19 || Works out of box || hda-intel || Works out of box || Untested || Untested || Untested || Web cam works, touchpad works, card reader untested || {{ic|1=acpi_backlight=vendor}} in bootloader<br />
|-<br />
| [[ASUS G73SW|G73SW]] || 2011.08.19 || nvidia || hda-intel || Works out of box || Works out of box || None || Untested || Backlit keys worked when I installed [[GNOME]] || Power settings need work...<br />
|-<br />
| Q400A || || Works out of box using i915 || hda-intel, mic works || AR8151v2 works out of box || Works out of box || Works out of the box || Suspend works, Hibernate untested || Backlit keys work on GNOME 3, screen backlight works with keys in gnome-3.10, touchpad works, webcam works, card reader works, HDMI output untested ||<br />
|-<br />
| [[ASUS Q500A|Q500A]] || 2015.02.01 || {{pkg|xf86-video-intel}}, works out of box || hda-intel, works out of box || r8169, works out of box || iwlwifi, works out of box || untested but detected by bluez || Suspend works, Hibernate works. || || || Works very well with Arch Linux<br />
|-<br />
| K55VM || 2013.04.01 || Contains NVIDIA Optimus, both works. Intel and Nvidia(proprietary drivers) || hda-intel || r8168 module, works || ath9k Works out of box || Untested || suspend and hibernate both work with gnome power manager and [[laptop-mode-tools]] || Web cam works, touchpad works, card reader works, sound card works || Highly compatible with Arch Linux. Technology optimus works with [[Bumblebee]]<br />
|-<br />
| [[ASUS A55VJ|A55VJ]] || 2013.05.01 || Contains NVIDIA Optimus, both work (NVIDIA only via [[Bumblebee]]) || hda-intel || r8169 module works || iwlwifi || Works with bluez || suspend works out of box with systemd/logind.conf || Web cam works, touchpad works, card reader works || Highly compatible with Arch Linux. Add {{ic|1=i8042.nomux=1}} to kernel line to prevent jittery touchpad.<br />
|-<br />
| S300CA || 2013.08.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel || Atheros AR8161, works out of the box || Atheros AR9485, works out of the box with ath9k || not tested || works, slightly higher power usage as Windows 8, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Web cam, touchpad, touchscreen all work, USB 3.0 and car reader not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
| S400CA || 2015.02.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel, works out of the box|| Atheros AR8161, works out of the box || Atheros AR9485, works out of the box || not tested || works, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Webcam work out of the box, touchpad work out of the box with xf86-input-synaptics, touchscreen all work, card reader works out of the box, USB 3.0 not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
<br />
| [[X502CA]] || 2013.07.01 || Integrated Intel HD Graphics works || hda-intel works || Qualcomm Atheros AR816x/AR817x, did not work during installation, after that works, but check model specific wiki || Ralink RT3290 performs very poorly with standard kernel driver. Check model specific wiki || not tested || suspend works, see model specific wiki for display brightness control || not tested || not a very good choice for Linux due to Wi-Fi problems<br />
|-<br />
| X53BR/K53BR || anything since 3.11 kernel || ATI 6320/ATI 7470 works, but can't disable discrete. Intervention needed since 3.13 || hda-intel works || Realtek with r8169 driver, out-of-the-box || Qualcomm Atheros AR9485 with ath9k driver, out-of-the-box || - || three different brightness switches in /sys/class/backlight for the same display, anything else fine || webcam fine || heats up very fast, description coming<br />
|-<br />
| X551CA || 2014. 03. 24. || Integrated Intel, works with {{pkg|xf86-video-intel}} || hda-intel || Realtek r8169, did not tested || Qualcomm Atheros AR9485, oob, but problems with NetworkManager - disabling the wifi hardblocks the card and Fn+F2 doesn't work. Workaround on [http://ubuntuforums.org/showthread.php?t=2181558 Ubuntu forum.] || not tested || I didn't tested yet, but at first sight it seems ok. || not tested. || It seems to work well with Linux<br />
|-<br />
| [[N550JV]] || 2014.03.01. || Hybrid graphics with integrated [[Intel]] and NVIDIA GeForce GT 750M [[Nouveau]] working with [[Bumblebee]] ([[NVIDIA]] driver works but not tested extensively) || snd_hda_intel works but external speakers pop on sleep/shutdown || Realtek r8169 works out of box || Qualcomm Atheros AR9485 works with ath9k out of the box || not tested || working, USB must be disabled before sleep || no modem || Card reader works out of box, has battery issues when a powered device is left plugged into the USB charging port.<br />
|-<br />
| G550JK || 2014.08.01 || Uses Nvidia Optimus, works fine with [[Bumblebee]] using Nvidia's drivers || snd_hda_intel - some background noises while using headphones: here is a [http://xps13-9333.appspot.com/#background_noise fix] || Not tested || Works out of the box || Not tested || I didn't tested much but it seems to work || Not tested || touchpad and camera works fine<br />
|-<br />
| X83VB-X2 || 2014.09.01 || GeForce 9300M GS, Works out of the box with xf86-video-intel || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || Ethernet works out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works, Camera not tested<br />
|-<br />
| [[ASUS Zenbook UX303|UX303LN]] || 2014.10.01 || GeForce 840M & Intel HD Graphics, Had to install [[Bumblebee]] to get both working || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || USB-to-Ethernet devices seem to work fine out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works (no gestures currently), Camera works fine, Touchscreen works (no multi-touch support) || Avoid some power management features due to Kernel Bug 102091.<br />
|-<br />
| UX32L(N) || N/A || GeForce 840M & Intel HD Graphics (Haswell-ULT rev09), Use [[Bumblebee#Default_power_state_of_NVIDIA_card_using_bbswitch|bbswitch]] and the Intel GPU as the proprietary nvidia driver breaks vsync and may cause crashes in Plasma 5. || Works out of box || Factory-supplied USB-to-Ethernet adapter works || Qualcomm Atheros AR9462 with ath9k driver or Intel with iwlwifi, out-of-the-box || Bluetooth works with bluez5 || Suspend and Hibernate work || || Set the kernel parameters {{ic|1=video.use_native_backlight=1 acpi_osi=}} for working backlight keys and backlight restore. Webcam, keyboard backlight and adjustment thereof works. || Clickpad works with libinput and synaptics. Testing of synaptics settings to get comfortable options needed. Avoid activating some power management features due to Kernel Bug 102091.<br />
|-<br />
| U32U || 2015.02.01 || Radeon 6320, Install xf86-video-ati || Works out of box (with ALSA) || Works out of the box || Works out of the box. For [[rfkill]] issues {{ic|options asus_nb_wmi wapf&#61;1}} may help|| Bluetooth works with bluez5, optionally install bluetooth manager || Suspend does not work. CPU Fan constantly on. || Webcam works || Needs significant setup to function properly. Power management hard to get right.<br />
|-<br />
| [[ASUS X553MA|X553MA]] || 2015.06.01 || Works || Works || Works || [[Broadcom_wireless#broadcom-wl|broadcom-wl]] (causes freezes) || Untested || Suspend works || || Set {{ic|OS Selection}} in BIOS setup to {{ic|Windows 7}}<br />
|-<br />
| F550J (aka A550J) || 2015.09.01 || Intel HD4600(integrated, works well witth {{Pkg|xf86-video-intel}}), Nvidia 850M(can't enter [[GNOME]] desktop environment(message "Critical issue") with driver {{Pkg|nvidia}} installed) || Intel HD Audio with [[ALSA]] || Works out of box : Realtek Semiconductor Co., Ltd. RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller (rev 12) || Broadcom Corporation BCM43142 802.11b/g/n (rev 01), works well with {{Pkg|broadcom-wl-dkms}} installed (refer to [[Broadcom wireless]]) || Not tested || Not tested || N/A || You should install {{Pkg|xf86-input-synaptics}} to enable touchpad || Recommend to disable standalone graphic card <br />
|-<br />
| [[ASUS N550JX|N550JX]] || 2015.12.01 || Works || Works || Works || Works || Works || Works || N/A |||| Read [[ASUS_N550JX|N550JX]]<br />
|-<br />
| [[ASUS X552M|X552M]] || 2015.12.01 || Intel HD works good with {{Pkg|xf86-video-intel}}, for Nvidia use bumblebee & nvidia. || Works || Works || Works with 'broadcom-wl-dkms' || Untested || Works || N/A ||Add 'acpi_osi= acpi_backlight=native' to bootloader kernel line for changing backlight with keyboard combo keys (fn + f5 / fn + f6)|| Read [[ASUS_X552M|X552M]]<br />
|-<br />
| [[ASUS E403SA|E403SA]] || 2016.06.01 || Integrated Intel HD Graphics 400 (Braswell), works well with {{Pkg|xf86-video-intel}}. || snd_hda_intel, works out of the box || not tested, no ethernet port || ath9k, works out of the box || not tested || suspend and brightness control works, but not with ACPI keys || works out of the box || Card reader not tested. ACPI/Function keys and lid switch do not work and will not show up on acpi_listen; except for mute, volup, voldown. With acpi="!Windows 2012" all ACPI functions work perfectly but the touchpad gets disabled entirely.<br />
|-<br />
| F555UA || 2016.08.14 || Intel HD works good with {{Pkg|xf86-video-intel}} || Sound works well, have to add `options snd-hda-intel model=laptop-dmic position_fix=3 ac97_quirck=alc_jack` to /etc/modprobe.d/alsa-base.conf to get mic to work and headphone/mic to work || Ethernet works RTL8111/8168/8411 || Wireless gives Kernel Panic RTL8821AE, have to blacklist on boot or msg will flood screen, replaced with AR9462 PCIe wireless card instead of trying to fix || Bluetooth does not work out of box, replaced with AR9462 card || Suspend and Brightness work haven't tried with keys || n/a || Issues with touchpad, no two finger scroll, very buggy touch, tried {{AUR|linux-elanfix}}{{Broken package link|package not found}} does not improve. tried the other asus and elantech pkgs, no joy|| If start xserver, can reinstatiate RTL8821AE driver and it will work, but floods logs with kernel panic msg.<br />
|-<br />
| K501J || Most recent as of 2016.09.01 || OK || OK || Not tested || OK || n/a || Brightness works with keys on Gnome 3 || n/a || Touchpad works with xf86-input-libinput, but somewhat uncomfortable. Better with xf86-input-synaptics, however pacman says "xf86-input-synaptics driver is on maintenance mode and xf86-input-libinput driver must be prefered over."<br />
|-<br />
| VivoBook S301LA || 2016.09.01 || Intel HD Graphics 4400, works well with {{Pkg|xf86-video-intel}} || Works || Works out of the box with r8169 module, also with {{Pkg|r8168}} || Works, atk9k module || Works || Add the boot option {{ic|1=acpi_osi=}} for hotkeys and backlight control to work. For package power states lower than PC3, see Remarks. || Webcam works || Touchpad, touchscreen and card reader works out of the box || To reach PC7, {{Pkg|r8168}} has to be built without certain build options. An easy way to do this is to build {{AUR|r8168-dkms}} after modifying its dkms.conf by removing {{ic|1=EXTRA_CFLAGS='-DCONFIG_R8168_NAPI -DCONFIG_R8168_VLAN'}}<br />
|-<br />
| K501LX || 2017.01.01 || Intel HD Graphics and GeForce GTX 950M. Configured and working with {{Pkg|bumblebee}} - see note. || Works || Works || Works || Works || Everything works out of box except keyboard backlight controls. Backlight can be controlled in GNOME without additional configuration. Using {{AUR|laptop-mode-tools}} generaly yields 4-5 hour battery life for light work and 1.5 hours for intensive work with the GPU on. || Works || Touchpad, and card reader works out of the box || Had issues using Bumblebee version with {{Pkg|linux}} version 4.9 (as of 2/25/2017). Added {{ic|1=pcie_port_pm=off}} to kernel parameters to make {{Pkg|bbswitch}} work correctly.<br />
|-<br />
| R540SA || 2017.03.01 || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box ||<br />
|-<br />
| [[N551VW]] || 2017.06.01 || nVidia Optimus + {{Pkg|xf86-video-intel}} || works via HDMI out of box, TBC || Works out of box || Works out of box || not yet tested, TBC || not yet tested, TBC || n/a || n/a ||<br />
|-<br />
| [[UX430UA]] || 2017.06.01 || Intel HD 620(Both Modsetting and xf86-video-intel drivers || Works out of the box. May need to add "options snd-hda-intel model=laptop" to /modprobe.d/alsabase.conf file. Important!!! You need to shutdown your PC for the fix to take affect (reboot doesn't take effect). Also check this [https://askubuntu.com/questions/686361/no-sound-through-headphones-while-speakers-work-fine?rq=1 thread] helps me to solve headphones problem. || Does not have Ethernet, but USB dongle works fine || Works out of the box || Works out of the box || Works out of box. TLP and PowerTop allows 7 - 8 hours battery life || Does not have a Modem || Comments: Laptop works beautifully with Linux, though PWM Fan control is not available (common issue on Zenbook range) ||<br />
|-<br />
| UX390UA || 2018.05.01 || Intel HD 620 - install {{Pkg|xf86-video-intel}} ||May need to apply [[ASUS_Zenbook_UX390|this]] fix for volume control||No integrated Ethernet, usb-c dongle works|| Works out of the box || Works out of the box || Works out of the box. TLP allows 8 - 9 hours battery life || Does not have a Modem ||PWM Fan control is not available (common issue on Zenbook range) ||<br />
|-<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
! rowspan="2" | Remarks<br />
|-<br />
! colspan="8" | Hardware support<br />
|}</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=521203ASUS ROG GL702ZC2018-05-14T18:56:28Z<p>Bbaserdem: /* = Secure Boot */ Fixed typo</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/leds/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/leds/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Fans don't have OS control, and handled by ACPI. Upshot is works out of the box, downside is can't configure them.<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ===<br />
<br />
The BIOS has an utility to load your own BIOS keys, which was glitching for my FAT32 formatted USB drive. Tried using keytool, which bricked the computer. I suggest further work into this.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=521202ASUS ROG GL702ZC2018-05-14T18:56:13Z<p>Bbaserdem: /* Troubleshooting */ /included a problem with secure boot</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/leds/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/leds/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Fans don't have OS control, and handled by ACPI. Upshot is works out of the box, downside is can't configure them.<br />
<br />
== Troubleshooting ==<br />
<br />
=== Secure Boot ==<br />
<br />
The BIOS has an utility to load your own BIOS keys, which was glitching for my FAT32 formatted USB drive. Tried using keytool, which bricked the computer. I suggest further work into this.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=518725ASUS ROG GL702ZC2018-04-25T19:07:58Z<p>Bbaserdem: /* Fans */ Changed description.</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard_backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/leds/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/leds/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Fans don't have OS control, and handled by ACPI. Upshot is works out of the box, downside is can't configure them.<br />
<br />
== Troubleshooting ==<br />
<br />
Compton with default settings don't work.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=518724ASUS ROG GL702ZC2018-04-25T19:06:51Z<p>Bbaserdem: /* Backlight */ Fixed typo in udev rule.</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ASUS GL702ZC]]<br />
This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard_backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/leds/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/leds/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Haven't checked yet, but seemingly works fine.<br />
<br />
== Troubleshooting ==<br />
<br />
Compton with default settings don't work.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=Laptop/ASUS&diff=518723Laptop/ASUS2018-04-25T19:00:10Z<p>Bbaserdem: /* Model List */ Added some details to ASUS GL702ZC</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ノートパソコン/Asus]]<br />
{{Laptops navigation}}<br />
<br />
== Model List ==<br />
<br />
{| class="wikitable sortable"<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! colspan="8" |Hardware support <br />
! class="unsortable" rowspan=2 | Remarks<br />
|-<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
<br />
|-<br />
| [[ASUS GL702ZC]] (ROG Strix AMD) || 2017.04.01 || Radeon RX580 - Kernel AMDGPU driver works great. || Pulseaudio works well. (Did not test HDMI audio autput) || Works || Archiso couldn't connect to wireless, but no problems afterwards || Works || Haven't tested [[TLP]] benefits. Notably bad battery life; about 1 hour on standby. || Haven't tested || Earlier kernels probably does not work with Ryzen CPU, but did not test. || Backlight keys don't work out of the box, see wiki page for fix. Compton crashes GUI, will explore settings. Fancontrol is ACPI, no OS controls.<br />
|-<br />
|-<br />
| ASUS GL552VM-DM-802D || 2017.02.01 || GTX960m - need nvidia proprietary driver with specific boot kernel otherwise due to a kernel lockup, you won't be able to boot. '''acpi_osi=! acpi_osi='Windows 2009'''' || works out of the box using pulseaudio || works out of the box || works out of the box || not tested || still testing || not tested || || need to add acpi_backlight=native to have fn keys backlight control and idle=nomwait<br />
|-<br />
|-<br />
| ASUS G502VM-FY017T || 2017.02.01 || GTX1060 3G - i use nvidia proprietaries driver it work fine after done an "mhwd-kernel -i linux410 & reboot" , nouveau not tested || works out of the box using pulseaudio (KDE stock) || works out of the box || works out of the box || works out the box (and using a Bluetooh headset like a Bose Qc35 works fine after a little workaround) || ~3.75hrs in normal use, with decent screen brightness, seems the same as what IÂ get on Windows 10 || not tested || Most Fn keys, sound control, works out the box, but the screen ajustment need a little workaround and it's fine|| Do ''not'' install intel drivers. This laptop does not have integrated graphics. <br />
|-<br />
| FX502VM || 2017.02.01 || GTX1060 3G - install nvidia, nouveau does not work || works out of the box using pulseaudio || works out of the box with r8169 || works out of the box || not tested || ~3hrs in normal use, with decent screen brightness || not tested || Fn keys does not send ACPI events, except F10,F11,F12 (sound control) || Do ''not'' install intel drivers. This laptop does not have integrated graphics.<br />
|-<br />
| [[ASUS Zenbook UX305|UX305FA]] || 2016.10.01 || Intel HD 5300 - install {{pkg|xf86-video-intel}} || works out of the box in [[GNOME]], [[i3]] works with pulseaudio || Intel - works out of the box || 802.11 ac module, works out of the box || works out of the box in [[GNOME]] || around 4 hours of battery life under decent load, gets quite hot, but never throttles || webcam works || Function keys for brightness (F5/F6) don't send ACPI events, F3 and F4 do, however. <br />
|-<br />
| K55N || 2014.11.12 || Radeon HD 7520G - install {{pkg|xf86-video-ati}} || snd,snd_hda_codec works out of the box using pulseaudio || r8169 module, out of the box || ath9k module, out of the box || not present|| Overheats and immediately shuts down on modern 3D games. Use thermald to control temp using acpi_cpufreq || webcam works || Fix fn brightness keys with "acpi_osi="!Windows 2012" video.use_native_backlight=1". Don't enable early radeon hook to prevent blank screen after hibernation. Fix blank screen on suspend to ram with "sysctl -w kernel.acpi_video_flags=3". <br />
|-<br />
| X401U || 2014.01.05 || Radeon HD 7340 - install {{pkg|xf86-video-ati}} || did not work out of the box, never configured correctly, using pulse, everything works || not tested || Wi-Fi out of the box || none to support|| all power options work just fine || webcam works || overall performance is satisfactory<br />
|-<br />
| X401A/X401A1 || 2013.05.01 || Integrated Intel HD Graphics - install {{pkg|xf86-video-intel}} and {{pkg|libva-intel-driver}}, enable SNA || hda-intel works, headphone jack, mic works || Realtek, out of the box || Wi-Fi out of the box || not tested || all power options work just fine, only brightness control needs module asus-nb-wmi to be loaded and {{ic|1=acpi_backlight=intel acpi_osi=}} [[GRUB]] options as of kernel 3.9.4 || webcam works || overall performance is satisfactory<br />
|-<br />
| W7S || Don't Panic || 3D with NVIDIA drivers || hda-intel || r8169 module, out of the box || Intel 4965 works with iwlwifi || works out of the box || || webcam works with uvc drivers, but it is mounted upside down || ACPI works with acpi4asus and acpid<br />
|-<br />
| N80Vn-X5 || 2009.02RC2 || 3D with NVIDIA drivers || hda-intel plus adding {{ic|1=options snd-hda-intel enable=1 model=g50v position_fix=0}} to {{ic|/etc/modprobe.d/modprobe.conf}} || Out of box with r8169 module || out of box with ath9k || out of box || || webcam and card reader both work out of the box || ACPI works fine with the {{ic|asus_laptop}} module<br />
|-<br />
| F8SN || 2009.08 || only tried with open source NV drivers (got 1280x800 pixels default without xorg edit), 3D proprietary will probably work || hda-intel || Ethernet works out of the box || Intel 4965 works with iwlwifi || untested-but is recognized by kernel || untested-battery status can be detected and customization options exist || Syntek Sonic web cam and Ricoh Card reader work out of the box (might need to allow user mount privileges just as you would for other ext. drives) || Highly compatible with Arch Linux<br />
|-<br />
| L3000D || Most recent as of 2010-02-13 || Works out of box || Works out of box || Works out of box || Not contains || Not contains || Works perfectly || Untested || <br />
|-<br />
| [[ASUS N53JN|N53JN]] || Most recent as of 2010-11-03 || Contains NVIDIA Optimus, so only Intel graphic card works. Waiting for NVIDIA to support Optimus on Linux || Works, needs some editing of modprobe files || Works out of box || ath9k || Untested || Hibernate untested, suspend works but with problems due to USB3 controller || Web cam works, touchpad works, media buttons work ||<br />
|-<br />
| N53SV || Most recent as of 2011-06-26 || Contains NVIDIA Optimus, so only Intel graphic card works.|| hda-intel || r8169 module, works out of box || ath9k needs madwifi || Untested || [https://bbs.archlinux.org/viewtopic.php?pid=910195 BBS thread] || Web cam works, touchpad works, card reader works. See also [https://help.ubuntu.com/community/Asus_N53 Ubuntu help]||<br />
|-<br />
| A8Le || Most recent as of 2011-07-31 || Works out of box || Works out of box (with [[ALSA]], 'Speaker' channel should be un-muted) || Out of box with r8169 module || Untested || Untested || Untested|| Touchpad works ||<br />
|-<br />
| 1005HA || 2011.08.19 || Works out of box using i915 || hda-intel || Works out of box || ath9k || Untested || Untested || ||<br />
|-<br />
| 1015E || 2014.05.19 || Works out of box using i915 || hda-intel || Works out of the box. || Wifi out of the box. || Untested || Display brightness and toggle, battery management, power, lid close works out of the box. Suspend works out of the box. Hibernate works after following instructions [[Suspend and hibernate#Hibernation|here]]. || Touchpad requires {{pkg|xf86-input-synaptics}} package. Webcam/mic works. Card reader works. USB 3.0 untested. || Overall satisfactory. {{pkg|efibootmgr}} v0.12 doesn't work, and v0.11 is recommended. {{pkg|linux}} kernel v4.3 and v4.4 has kswapd0 bug. {{pkg|linux-lts}} is recommended until fixed. Only display, audio and sleep fn keys are recognized.<br />
|-<br />
| [[ASUS UL30A|UL30A]] || 2011.08.19 || Works out of box || hda-intel || Works out of box || Untested || Untested || Untested || Web cam works, touchpad works, card reader untested || {{ic|1=acpi_backlight=vendor}} in bootloader<br />
|-<br />
| [[ASUS G73SW|G73SW]] || 2011.08.19 || nvidia || hda-intel || Works out of box || Works out of box || None || Untested || Backlit keys worked when I installed [[GNOME]] || Power settings need work...<br />
|-<br />
| Q400A || || Works out of box using i915 || hda-intel, mic works || AR8151v2 works out of box || Works out of box || Works out of the box || Suspend works, Hibernate untested || Backlit keys work on GNOME 3, screen backlight works with keys in gnome-3.10, touchpad works, webcam works, card reader works, HDMI output untested ||<br />
|-<br />
| [[ASUS Q500A|Q500A]] || 2015.02.01 || {{pkg|xf86-video-intel}}, works out of box || hda-intel, works out of box || r8169, works out of box || iwlwifi, works out of box || untested but detected by bluez || Suspend works, Hibernate works. || || || Works very well with Arch Linux<br />
|-<br />
| K55VM || 2013.04.01 || Contains NVIDIA Optimus, both works. Intel and Nvidia(proprietary drivers) || hda-intel || r8168 module, works || ath9k Works out of box || Untested || suspend and hibernate both work with gnome power manager and [[laptop-mode-tools]] || Web cam works, touchpad works, card reader works, sound card works || Highly compatible with Arch Linux. Technology optimus works with [[Bumblebee]]<br />
|-<br />
| [[ASUS A55VJ|A55VJ]] || 2013.05.01 || Contains NVIDIA Optimus, both work (NVIDIA only via [[Bumblebee]]) || hda-intel || r8169 module works || iwlwifi || Works with bluez || suspend works out of box with systemd/logind.conf || Web cam works, touchpad works, card reader works || Highly compatible with Arch Linux. Add {{ic|1=i8042.nomux=1}} to kernel line to prevent jittery touchpad.<br />
|-<br />
| S300CA || 2013.08.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel || Atheros AR8161, works out of the box || Atheros AR9485, works out of the box with ath9k || not tested || works, slightly higher power usage as Windows 8, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Web cam, touchpad, touchscreen all work, USB 3.0 and car reader not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
| S400CA || 2015.02.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel, works out of the box|| Atheros AR8161, works out of the box || Atheros AR9485, works out of the box || not tested || works, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Webcam work out of the box, touchpad work out of the box with xf86-input-synaptics, touchscreen all work, card reader works out of the box, USB 3.0 not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
<br />
| [[X502CA]] || 2013.07.01 || Integrated Intel HD Graphics works || hda-intel works || Qualcomm Atheros AR816x/AR817x, did not work during installation, after that works, but check model specific wiki || Ralink RT3290 performs very poorly with standard kernel driver. Check model specific wiki || not tested || suspend works, see model specific wiki for display brightness control || not tested || not a very good choice for Linux due to Wi-Fi problems<br />
|-<br />
| X53BR/K53BR || anything since 3.11 kernel || ATI 6320/ATI 7470 works, but can't disable discrete. Intervention needed since 3.13 || hda-intel works || Realtek with r8169 driver, out-of-the-box || Qualcomm Atheros AR9485 with ath9k driver, out-of-the-box || - || three different brightness switches in /sys/class/backlight for the same display, anything else fine || webcam fine || heats up very fast, description coming<br />
|-<br />
| X551CA || 2014. 03. 24. || Integrated Intel, works with {{pkg|xf86-video-intel}} || hda-intel || Realtek r8169, did not tested || Qualcomm Atheros AR9485, oob, but problems with NetworkManager - disabling the wifi hardblocks the card and Fn+F2 doesn't work. Workaround on [http://ubuntuforums.org/showthread.php?t=2181558 Ubuntu forum.] || not tested || I didn't tested yet, but at first sight it seems ok. || not tested. || It seems to work well with Linux<br />
|-<br />
| [[N550JV]] || 2014.03.01. || Hybrid graphics with integrated [[Intel]] and NVIDIA GeForce GT 750M [[Nouveau]] working with [[Bumblebee]] ([[NVIDIA]] driver works but not tested extensively) || snd_hda_intel works but external speakers pop on sleep/shutdown || Realtek r8169 works out of box || Qualcomm Atheros AR9485 works with ath9k out of the box || not tested || working, USB must be disabled before sleep || no modem || Card reader works out of box, has battery issues when a powered device is left plugged into the USB charging port.<br />
|-<br />
| G550JK || 2014.08.01 || Uses Nvidia Optimus, works fine with [[Bumblebee]] using Nvidia's drivers || snd_hda_intel - some background noises while using headphones: here is a [http://xps13-9333.appspot.com/#background_noise fix] || Not tested || Works out of the box || Not tested || I didn't tested much but it seems to work || Not tested || touchpad and camera works fine<br />
|-<br />
| X83VB-X2 || 2014.09.01 || GeForce 9300M GS, Works out of the box with xf86-video-intel || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || Ethernet works out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works, Camera not tested<br />
|-<br />
| [[ASUS Zenbook UX303|UX303LN]] || 2014.10.01 || GeForce 840M & Intel HD Graphics, Had to install [[Bumblebee]] to get both working || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || USB-to-Ethernet devices seem to work fine out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works (no gestures currently), Camera works fine, Touchscreen works (no multi-touch support) || Avoid some power management features due to Kernel Bug 102091.<br />
|-<br />
| UX32L(N) || N/A || GeForce 840M & Intel HD Graphics (Haswell-ULT rev09), Use [[Bumblebee#Default_power_state_of_NVIDIA_card_using_bbswitch|bbswitch]] and the Intel GPU as the proprietary nvidia driver breaks vsync and may cause crashes in Plasma 5. || Works out of box || Factory-supplied USB-to-Ethernet adapter works || Qualcomm Atheros AR9462 with ath9k driver or Intel with iwlwifi, out-of-the-box || Bluetooth works with bluez5 || Suspend and Hibernate work || || Set the kernel parameters {{ic|1=video.use_native_backlight=1 acpi_osi=}} for working backlight keys and backlight restore. Webcam, keyboard backlight and adjustment thereof works. || Clickpad works with libinput and synaptics. Testing of synaptics settings to get comfortable options needed. Avoid activating some power management features due to Kernel Bug 102091.<br />
|-<br />
| U32U || 2015.02.01 || Radeon 6320, Install xf86-video-ati || Works out of box (with ALSA) || Works out of the box || Works out of the box. For [[rfkill]] issues {{ic|options asus_nb_wmi wapf&#61;1}} may help|| Bluetooth works with bluez5, optionally install bluetooth manager || Suspend does not work. CPU Fan constantly on. || Webcam works || Needs significant setup to function properly. Power management hard to get right.<br />
|-<br />
| [[ASUS X553MA|X553MA]] || 2015.06.01 || Works || Works || Works || [[Broadcom_wireless#broadcom-wl|broadcom-wl]] (causes freezes) || Untested || Suspend works || || Set {{ic|OS Selection}} in BIOS setup to {{ic|Windows 7}}<br />
|-<br />
| F550J (aka A550J) || 2015.09.01 || Intel HD4600(integrated, works well witth {{Pkg|xf86-video-intel}}), Nvidia 850M(can't enter [[GNOME]] desktop environment(message "Critical issue") with driver {{Pkg|nvidia}} installed) || Intel HD Audio with [[ALSA]] || Works out of box : Realtek Semiconductor Co., Ltd. RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller (rev 12) || Broadcom Corporation BCM43142 802.11b/g/n (rev 01), works well with {{Pkg|broadcom-wl-dkms}} installed (refer to [[Broadcom wireless]]) || Not tested || Not tested || N/A || You should install {{Pkg|xf86-input-synaptics}} to enable touchpad || Recommend to disable standalone graphic card <br />
|-<br />
| [[ASUS N550JX|N550JX]] || 2015.12.01 || Works || Works || Works || Works || Works || Works || N/A |||| Read [[ASUS_N550JX|N550JX]]<br />
|-<br />
| [[ASUS X552M|X552M]] || 2015.12.01 || Intel HD works good with {{Pkg|xf86-video-intel}}, for Nvidia use bumblebee & nvidia. || Works || Works || Works with 'broadcom-wl-dkms' || Untested || Works || N/A ||Add 'acpi_osi= acpi_backlight=native' to bootloader kernel line for changing backlight with keyboard combo keys (fn + f5 / fn + f6)|| Read [[ASUS_X552M|X552M]]<br />
|-<br />
| [[ASUS E403SA|E403SA]] || 2016.06.01 || Integrated Intel HD Graphics 400 (Braswell), works well with {{Pkg|xf86-video-intel}}. || snd_hda_intel, works out of the box || not tested, no ethernet port || ath9k, works out of the box || not tested || suspend and brightness control works, but not with ACPI keys || works out of the box || Card reader not tested. ACPI/Function keys and lid switch do not work and will not show up on acpi_listen; except for mute, volup, voldown. With acpi="!Windows 2012" all ACPI functions work perfectly but the touchpad gets disabled entirely.<br />
|-<br />
| F555UA || 2016.08.14 || Intel HD works good with {{Pkg|xf86-video-intel}} || Sound works well, have to add `options snd-hda-intel model=laptop-dmic position_fix=3 ac97_quirck=alc_jack` to /etc/modprobe.d/alsa-base.conf to get mic to work and headphone/mic to work || Ethernet works RTL8111/8168/8411 || Wireless gives Kernel Panic RTL8821AE, have to blacklist on boot or msg will flood screen, replaced with AR9462 PCIe wireless card instead of trying to fix || Bluetooth does not work out of box, replaced with AR9462 card || Suspend and Brightness work haven't tried with keys || n/a || Issues with touchpad, no two finger scroll, very buggy touch, tried {{AUR|linux-elanfix}}{{Broken package link|package not found}} does not improve. tried the other asus and elantech pkgs, no joy|| If start xserver, can reinstatiate RTL8821AE driver and it will work, but floods logs with kernel panic msg.<br />
|-<br />
| K501J || Most recent as of 2016.09.01 || OK || OK || Not tested || OK || n/a || Brightness works with keys on Gnome 3 || n/a || Touchpad works with xf86-input-libinput, but somewhat uncomfortable. Better with xf86-input-synaptics, however pacman says "xf86-input-synaptics driver is on maintenance mode and xf86-input-libinput driver must be prefered over."<br />
|-<br />
| VivoBook S301LA || 2016.09.01 || Intel HD Graphics 4400, works well with {{Pkg|xf86-video-intel}} || Works || Works out of the box with r8169 module, also with {{Pkg|r8168}} || Works, atk9k module || Works || Add the boot option {{ic|1=acpi_osi=}} for hotkeys and backlight control to work. For package power states lower than PC3, see Remarks. || Webcam works || Touchpad, touchscreen and card reader works out of the box || To reach PC7, {{Pkg|r8168}} has to be built without certain build options. An easy way to do this is to build {{AUR|r8168-dkms}} after modifying its dkms.conf by removing {{ic|1=EXTRA_CFLAGS='-DCONFIG_R8168_NAPI -DCONFIG_R8168_VLAN'}}<br />
|-<br />
| K501LX || 2017.01.01 || Intel HD Graphics and GeForce GTX 950M. Configured and working with {{Pkg|bumblebee}} - see note. || Works || Works || Works || Works || Everything works out of box except keyboard backlight controls. Backlight can be controlled in GNOME without additional configuration. Using {{AUR|laptop-mode-tools}} generaly yields 4-5 hour battery life for light work and 1.5 hours for intensive work with the GPU on. || Works || Touchpad, and card reader works out of the box || Had issues using Bumblebee version with {{Pkg|linux}} version 4.9 (as of 2/25/2017). Added {{ic|1=pcie_port_pm=off}} to kernel parameters to make {{Pkg|bbswitch}} work correctly.<br />
|-<br />
| R540SA || 2017.03.01 || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box ||<br />
|-<br />
| [[N551VW]] || 2017.06.01 || nVidia Optimus + {{Pkg|xf86-video-intel}} || works via HDMI out of box, TBC || Works out of box || Works out of box || not yet tested, TBC || not yet tested, TBC || n/a || n/a ||<br />
|-<br />
| [[UX430UA]] || 2017.06.01 || Intel HD 620(Both Modsetting and xf86-video-intel drivers || Works out of the box. May need to add "options snd-hda-intel model=laptop" to /modprobe.d/alsabase.conf file. Important!!! You need to shutdown your PC for the fix to take affect (reboot doesn't take effect). Also check this [https://askubuntu.com/questions/686361/no-sound-through-headphones-while-speakers-work-fine?rq=1 thread] helps me to solve headphones problem. || Does not have Ethernet, but USB dongle works fine || Works out of the box || Works out of the box || Works out of box. TLP and PowerTop allows 7 - 8 hours battery life || Does not have a Modem || Comments: Laptop works beautifully with Linux, though PWM Fan control is not available (common issue on Zenbook range) ||<br />
|-<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
! rowspan="2" | Remarks<br />
|-<br />
! colspan="8" | Hardware support<br />
|}</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=Laptop/ASUS&diff=518097Laptop/ASUS2018-04-20T22:29:40Z<p>Bbaserdem: /* Model List */ I added a new laptop model, ASUS GL702ZC</p>
<hr />
<div>[[Category:ASUS]]<br />
[[ja:ノートパソコン/Asus]]<br />
{{Laptops navigation}}<br />
<br />
== Model List ==<br />
<br />
{| class="wikitable sortable"<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! colspan="8" |Hardware support <br />
! class="unsortable" rowspan=2 | Remarks<br />
|-<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
<br />
|-<br />
| [[ASUS GL702ZC]] (ROG Strix AMD) || 2017.04.01 || Radeon RX580 - The default kernel amdgpu driver works OK; having some graphic freezes, but unsure if its the GPU || Works out of the box, pulseaudio || Works out of the box || Works out of the box || Works || Haven't tested [[TLP]], but notably bad battery life; about 1 hour on standby. || Haven't tested || Earlier kernels probably does not work with Ryzen CPU, but did not test. || Backlight keys don't work out <br />
of the box, see wiki page for fix<br />
|-<br />
|-<br />
| ASUS GL552VM-DM-802D || 2017.02.01 || GTX960m - need nvidia proprietary driver with specific boot kernel otherwise due to a kernel lockup, you won't be able to boot. '''acpi_osi=! acpi_osi='Windows 2009'''' || works out of the box using pulseaudio || works out of the box || works out of the box || not tested || still testing || not tested || || need to add acpi_backlight=native to have fn keys backlight control and idle=nomwait<br />
|-<br />
|-<br />
| ASUS G502VM-FY017T || 2017.02.01 || GTX1060 3G - i use nvidia proprietaries driver it work fine after done an "mhwd-kernel -i linux410 & reboot" , nouveau not tested || works out of the box using pulseaudio (KDE stock) || works out of the box || works out of the box || works out the box (and using a Bluetooh headset like a Bose Qc35 works fine after a little workaround) || ~3.75hrs in normal use, with decent screen brightness, seems the same as what IÂ get on Windows 10 || not tested || Most Fn keys, sound control, works out the box, but the screen ajustment need a little workaround and it's fine|| Do ''not'' install intel drivers. This laptop does not have integrated graphics. <br />
|-<br />
| FX502VM || 2017.02.01 || GTX1060 3G - install nvidia, nouveau does not work || works out of the box using pulseaudio || works out of the box with r8169 || works out of the box || not tested || ~3hrs in normal use, with decent screen brightness || not tested || Fn keys does not send ACPI events, except F10,F11,F12 (sound control) || Do ''not'' install intel drivers. This laptop does not have integrated graphics.<br />
|-<br />
| [[ASUS Zenbook UX305|UX305FA]] || 2016.10.01 || Intel HD 5300 - install {{pkg|xf86-video-intel}} || works out of the box in [[GNOME]], [[i3]] works with pulseaudio || Intel - works out of the box || 802.11 ac module, works out of the box || works out of the box in [[GNOME]] || around 4 hours of battery life under decent load, gets quite hot, but never throttles || webcam works || Function keys for brightness (F5/F6) don't send ACPI events, F3 and F4 do, however. <br />
|-<br />
| K55N || 2014.11.12 || Radeon HD 7520G - install {{pkg|xf86-video-ati}} || snd,snd_hda_codec works out of the box using pulseaudio || r8169 module, out of the box || ath9k module, out of the box || not present|| Overheats and immediately shuts down on modern 3D games. Use thermald to control temp using acpi_cpufreq || webcam works || Fix fn brightness keys with "acpi_osi="!Windows 2012" video.use_native_backlight=1". Don't enable early radeon hook to prevent blank screen after hibernation. Fix blank screen on suspend to ram with "sysctl -w kernel.acpi_video_flags=3". <br />
|-<br />
| X401U || 2014.01.05 || Radeon HD 7340 - install {{pkg|xf86-video-ati}} || did not work out of the box, never configured correctly, using pulse, everything works || not tested || Wi-Fi out of the box || none to support|| all power options work just fine || webcam works || overall performance is satisfactory<br />
|-<br />
| X401A/X401A1 || 2013.05.01 || Integrated Intel HD Graphics - install {{pkg|xf86-video-intel}} and {{pkg|libva-intel-driver}}, enable SNA || hda-intel works, headphone jack, mic works || Realtek, out of the box || Wi-Fi out of the box || not tested || all power options work just fine, only brightness control needs module asus-nb-wmi to be loaded and {{ic|1=acpi_backlight=intel acpi_osi=}} [[GRUB]] options as of kernel 3.9.4 || webcam works || overall performance is satisfactory<br />
|-<br />
| W7S || Don't Panic || 3D with NVIDIA drivers || hda-intel || r8169 module, out of the box || Intel 4965 works with iwlwifi || works out of the box || || webcam works with uvc drivers, but it is mounted upside down || ACPI works with acpi4asus and acpid<br />
|-<br />
| N80Vn-X5 || 2009.02RC2 || 3D with NVIDIA drivers || hda-intel plus adding {{ic|1=options snd-hda-intel enable=1 model=g50v position_fix=0}} to {{ic|/etc/modprobe.d/modprobe.conf}} || Out of box with r8169 module || out of box with ath9k || out of box || || webcam and card reader both work out of the box || ACPI works fine with the {{ic|asus_laptop}} module<br />
|-<br />
| F8SN || 2009.08 || only tried with open source NV drivers (got 1280x800 pixels default without xorg edit), 3D proprietary will probably work || hda-intel || Ethernet works out of the box || Intel 4965 works with iwlwifi || untested-but is recognized by kernel || untested-battery status can be detected and customization options exist || Syntek Sonic web cam and Ricoh Card reader work out of the box (might need to allow user mount privileges just as you would for other ext. drives) || Highly compatible with Arch Linux<br />
|-<br />
| L3000D || Most recent as of 2010-02-13 || Works out of box || Works out of box || Works out of box || Not contains || Not contains || Works perfectly || Untested || <br />
|-<br />
| [[ASUS N53JN|N53JN]] || Most recent as of 2010-11-03 || Contains NVIDIA Optimus, so only Intel graphic card works. Waiting for NVIDIA to support Optimus on Linux || Works, needs some editing of modprobe files || Works out of box || ath9k || Untested || Hibernate untested, suspend works but with problems due to USB3 controller || Web cam works, touchpad works, media buttons work ||<br />
|-<br />
| N53SV || Most recent as of 2011-06-26 || Contains NVIDIA Optimus, so only Intel graphic card works.|| hda-intel || r8169 module, works out of box || ath9k needs madwifi || Untested || [https://bbs.archlinux.org/viewtopic.php?pid=910195 BBS thread] || Web cam works, touchpad works, card reader works. See also [https://help.ubuntu.com/community/Asus_N53 Ubuntu help]||<br />
|-<br />
| A8Le || Most recent as of 2011-07-31 || Works out of box || Works out of box (with [[ALSA]], 'Speaker' channel should be un-muted) || Out of box with r8169 module || Untested || Untested || Untested|| Touchpad works ||<br />
|-<br />
| 1005HA || 2011.08.19 || Works out of box using i915 || hda-intel || Works out of box || ath9k || Untested || Untested || ||<br />
|-<br />
| 1015E || 2014.05.19 || Works out of box using i915 || hda-intel || Works out of the box. || Wifi out of the box. || Untested || Display brightness and toggle, battery management, power, lid close works out of the box. Suspend works out of the box. Hibernate works after following instructions [[Suspend and hibernate#Hibernation|here]]. || Touchpad requires {{pkg|xf86-input-synaptics}} package. Webcam/mic works. Card reader works. USB 3.0 untested. || Overall satisfactory. {{pkg|efibootmgr}} v0.12 doesn't work, and v0.11 is recommended. {{pkg|linux}} kernel v4.3 and v4.4 has kswapd0 bug. {{pkg|linux-lts}} is recommended until fixed. Only display, audio and sleep fn keys are recognized.<br />
|-<br />
| [[ASUS UL30A|UL30A]] || 2011.08.19 || Works out of box || hda-intel || Works out of box || Untested || Untested || Untested || Web cam works, touchpad works, card reader untested || {{ic|1=acpi_backlight=vendor}} in bootloader<br />
|-<br />
| [[ASUS G73SW|G73SW]] || 2011.08.19 || nvidia || hda-intel || Works out of box || Works out of box || None || Untested || Backlit keys worked when I installed [[GNOME]] || Power settings need work...<br />
|-<br />
| Q400A || || Works out of box using i915 || hda-intel, mic works || AR8151v2 works out of box || Works out of box || Works out of the box || Suspend works, Hibernate untested || Backlit keys work on GNOME 3, screen backlight works with keys in gnome-3.10, touchpad works, webcam works, card reader works, HDMI output untested ||<br />
|-<br />
| [[ASUS Q500A|Q500A]] || 2015.02.01 || {{pkg|xf86-video-intel}}, works out of box || hda-intel, works out of box || r8169, works out of box || iwlwifi, works out of box || untested but detected by bluez || Suspend works, Hibernate works. || || || Works very well with Arch Linux<br />
|-<br />
| K55VM || 2013.04.01 || Contains NVIDIA Optimus, both works. Intel and Nvidia(proprietary drivers) || hda-intel || r8168 module, works || ath9k Works out of box || Untested || suspend and hibernate both work with gnome power manager and [[laptop-mode-tools]] || Web cam works, touchpad works, card reader works, sound card works || Highly compatible with Arch Linux. Technology optimus works with [[Bumblebee]]<br />
|-<br />
| [[ASUS A55VJ|A55VJ]] || 2013.05.01 || Contains NVIDIA Optimus, both work (NVIDIA only via [[Bumblebee]]) || hda-intel || r8169 module works || iwlwifi || Works with bluez || suspend works out of box with systemd/logind.conf || Web cam works, touchpad works, card reader works || Highly compatible with Arch Linux. Add {{ic|1=i8042.nomux=1}} to kernel line to prevent jittery touchpad.<br />
|-<br />
| S300CA || 2013.08.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel || Atheros AR8161, works out of the box || Atheros AR9485, works out of the box with ath9k || not tested || works, slightly higher power usage as Windows 8, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Web cam, touchpad, touchscreen all work, USB 3.0 and car reader not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
| S400CA || 2015.02.01 || Intel HD Graphics 4000, works out of the box with xf86-video-intel || hda-intel, works out of the box|| Atheros AR8161, works out of the box || Atheros AR9485, works out of the box || not tested || works, for backlight add {{ic|1=acpi_osi=Linux acpi_backlight=vendor}} to bootloader kernel line || Webcam work out of the box, touchpad work out of the box with xf86-input-synaptics, touchscreen all work, card reader works out of the box, USB 3.0 not tested yet || Highly compatible with Arch Linux. <br />
|-<br />
<br />
| [[X502CA]] || 2013.07.01 || Integrated Intel HD Graphics works || hda-intel works || Qualcomm Atheros AR816x/AR817x, did not work during installation, after that works, but check model specific wiki || Ralink RT3290 performs very poorly with standard kernel driver. Check model specific wiki || not tested || suspend works, see model specific wiki for display brightness control || not tested || not a very good choice for Linux due to Wi-Fi problems<br />
|-<br />
| X53BR/K53BR || anything since 3.11 kernel || ATI 6320/ATI 7470 works, but can't disable discrete. Intervention needed since 3.13 || hda-intel works || Realtek with r8169 driver, out-of-the-box || Qualcomm Atheros AR9485 with ath9k driver, out-of-the-box || - || three different brightness switches in /sys/class/backlight for the same display, anything else fine || webcam fine || heats up very fast, description coming<br />
|-<br />
| X551CA || 2014. 03. 24. || Integrated Intel, works with {{pkg|xf86-video-intel}} || hda-intel || Realtek r8169, did not tested || Qualcomm Atheros AR9485, oob, but problems with NetworkManager - disabling the wifi hardblocks the card and Fn+F2 doesn't work. Workaround on [http://ubuntuforums.org/showthread.php?t=2181558 Ubuntu forum.] || not tested || I didn't tested yet, but at first sight it seems ok. || not tested. || It seems to work well with Linux<br />
|-<br />
| [[N550JV]] || 2014.03.01. || Hybrid graphics with integrated [[Intel]] and NVIDIA GeForce GT 750M [[Nouveau]] working with [[Bumblebee]] ([[NVIDIA]] driver works but not tested extensively) || snd_hda_intel works but external speakers pop on sleep/shutdown || Realtek r8169 works out of box || Qualcomm Atheros AR9485 works with ath9k out of the box || not tested || working, USB must be disabled before sleep || no modem || Card reader works out of box, has battery issues when a powered device is left plugged into the USB charging port.<br />
|-<br />
| G550JK || 2014.08.01 || Uses Nvidia Optimus, works fine with [[Bumblebee]] using Nvidia's drivers || snd_hda_intel - some background noises while using headphones: here is a [http://xps13-9333.appspot.com/#background_noise fix] || Not tested || Works out of the box || Not tested || I didn't tested much but it seems to work || Not tested || touchpad and camera works fine<br />
|-<br />
| X83VB-X2 || 2014.09.01 || GeForce 9300M GS, Works out of the box with xf86-video-intel || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || Ethernet works out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works, Camera not tested<br />
|-<br />
| [[ASUS Zenbook UX303|UX303LN]] || 2014.10.01 || GeForce 840M & Intel HD Graphics, Had to install [[Bumblebee]] to get both working || Works out of box (with ALSA, 'Speaker' channel should be un-muted) || USB-to-Ethernet devices seem to work fine out of the box || Wifi works out of the box || Bluetooth not tested || Not tested but seems to work fine || Not tested || Touchpad works (no gestures currently), Camera works fine, Touchscreen works (no multi-touch support) || Avoid some power management features due to Kernel Bug 102091.<br />
|-<br />
| UX32L(N) || N/A || GeForce 840M & Intel HD Graphics (Haswell-ULT rev09), Use [[Bumblebee#Default_power_state_of_NVIDIA_card_using_bbswitch|bbswitch]] and the Intel GPU as the proprietary nvidia driver breaks vsync and may cause crashes in Plasma 5. || Works out of box || Factory-supplied USB-to-Ethernet adapter works || Qualcomm Atheros AR9462 with ath9k driver or Intel with iwlwifi, out-of-the-box || Bluetooth works with bluez5 || Suspend and Hibernate work || || Set the kernel parameters {{ic|1=video.use_native_backlight=1 acpi_osi=}} for working backlight keys and backlight restore. Webcam, keyboard backlight and adjustment thereof works. || Clickpad works with libinput and synaptics. Testing of synaptics settings to get comfortable options needed. Avoid activating some power management features due to Kernel Bug 102091.<br />
|-<br />
| U32U || 2015.02.01 || Radeon 6320, Install xf86-video-ati || Works out of box (with ALSA) || Works out of the box || Works out of the box. For [[rfkill]] issues {{ic|options asus_nb_wmi wapf&#61;1}} may help|| Bluetooth works with bluez5, optionally install bluetooth manager || Suspend does not work. CPU Fan constantly on. || Webcam works || Needs significant setup to function properly. Power management hard to get right.<br />
|-<br />
| [[ASUS X553MA|X553MA]] || 2015.06.01 || Works || Works || Works || [[Broadcom_wireless#broadcom-wl|broadcom-wl]] (causes freezes) || Untested || Suspend works || || Set {{ic|OS Selection}} in BIOS setup to {{ic|Windows 7}}<br />
|-<br />
| F550J (aka A550J) || 2015.09.01 || Intel HD4600(integrated, works well witth {{Pkg|xf86-video-intel}}), Nvidia 850M(can't enter [[GNOME]] desktop environment(message "Critical issue") with driver {{Pkg|nvidia}} installed) || Intel HD Audio with [[ALSA]] || Works out of box : Realtek Semiconductor Co., Ltd. RTL8111/8168/8411 PCI Express Gigabit Ethernet Controller (rev 12) || Broadcom Corporation BCM43142 802.11b/g/n (rev 01), works well with {{Pkg|broadcom-wl-dkms}} installed (refer to [[Broadcom wireless]]) || Not tested || Not tested || N/A || You should install {{Pkg|xf86-input-synaptics}} to enable touchpad || Recommend to disable standalone graphic card <br />
|-<br />
| [[ASUS N550JX|N550JX]] || 2015.12.01 || Works || Works || Works || Works || Works || Works || N/A |||| Read [[ASUS_N550JX|N550JX]]<br />
|-<br />
| [[ASUS X552M|X552M]] || 2015.12.01 || Intel HD works good with {{Pkg|xf86-video-intel}}, for Nvidia use bumblebee & nvidia. || Works || Works || Works with 'broadcom-wl-dkms' || Untested || Works || N/A ||Add 'acpi_osi= acpi_backlight=native' to bootloader kernel line for changing backlight with keyboard combo keys (fn + f5 / fn + f6)|| Read [[ASUS_X552M|X552M]]<br />
|-<br />
| [[ASUS E403SA|E403SA]] || 2016.06.01 || Integrated Intel HD Graphics 400 (Braswell), works well with {{Pkg|xf86-video-intel}}. || snd_hda_intel, works out of the box || not tested, no ethernet port || ath9k, works out of the box || not tested || suspend and brightness control works, but not with ACPI keys || works out of the box || Card reader not tested. ACPI/Function keys and lid switch do not work and will not show up on acpi_listen; except for mute, volup, voldown. With acpi="!Windows 2012" all ACPI functions work perfectly but the touchpad gets disabled entirely.<br />
|-<br />
| F555UA || 2016.08.14 || Intel HD works good with {{Pkg|xf86-video-intel}} || Sound works well, have to add `options snd-hda-intel model=laptop-dmic position_fix=3 ac97_quirck=alc_jack` to /etc/modprobe.d/alsa-base.conf to get mic to work and headphone/mic to work || Ethernet works RTL8111/8168/8411 || Wireless gives Kernel Panic RTL8821AE, have to blacklist on boot or msg will flood screen, replaced with AR9462 PCIe wireless card instead of trying to fix || Bluetooth does not work out of box, replaced with AR9462 card || Suspend and Brightness work haven't tried with keys || n/a || Issues with touchpad, no two finger scroll, very buggy touch, tried {{AUR|linux-elanfix}}{{Broken package link|package not found}} does not improve. tried the other asus and elantech pkgs, no joy|| If start xserver, can reinstatiate RTL8821AE driver and it will work, but floods logs with kernel panic msg.<br />
|-<br />
| K501J || Most recent as of 2016.09.01 || OK || OK || Not tested || OK || n/a || Brightness works with keys on Gnome 3 || n/a || Touchpad works with xf86-input-libinput, but somewhat uncomfortable. Better with xf86-input-synaptics, however pacman says "xf86-input-synaptics driver is on maintenance mode and xf86-input-libinput driver must be prefered over."<br />
|-<br />
| VivoBook S301LA || 2016.09.01 || Intel HD Graphics 4400, works well with {{Pkg|xf86-video-intel}} || Works || Works out of the box with r8169 module, also with {{Pkg|r8168}} || Works, atk9k module || Works || Add the boot option {{ic|1=acpi_osi=}} for hotkeys and backlight control to work. For package power states lower than PC3, see Remarks. || Webcam works || Touchpad, touchscreen and card reader works out of the box || To reach PC7, {{Pkg|r8168}} has to be built without certain build options. An easy way to do this is to build {{AUR|r8168-dkms}} after modifying its dkms.conf by removing {{ic|1=EXTRA_CFLAGS='-DCONFIG_R8168_NAPI -DCONFIG_R8168_VLAN'}}<br />
|-<br />
| K501LX || 2017.01.01 || Intel HD Graphics and GeForce GTX 950M. Configured and working with {{Pkg|bumblebee}} - see note. || Works || Works || Works || Works || Everything works out of box except keyboard backlight controls. Backlight can be controlled in GNOME without additional configuration. Using {{AUR|laptop-mode-tools}} generaly yields 4-5 hour battery life for light work and 1.5 hours for intensive work with the GPU on. || Works || Touchpad, and card reader works out of the box || Had issues using Bumblebee version with {{Pkg|linux}} version 4.9 (as of 2/25/2017). Added {{ic|1=pcie_port_pm=off}} to kernel parameters to make {{Pkg|bbswitch}} work correctly.<br />
|-<br />
| R540SA || 2017.03.01 || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box || Works out of box ||<br />
|-<br />
| [[N551VW]] || 2017.06.01 || nVidia Optimus + {{Pkg|xf86-video-intel}} || works via HDMI out of box, TBC || Works out of box || Works out of box || not yet tested, TBC || not yet tested, TBC || n/a || n/a ||<br />
|-<br />
| [[UX430UA]] || 2017.06.01 || Intel HD 620(Both Modsetting and xf86-video-intel drivers || Works out of the box. May need to add "options snd-hda-intel model=laptop" to /modprobe.d/alsabase.conf file. Important!!! You need to shutdown your PC for the fix to take affect (reboot doesn't take effect). Also check this [https://askubuntu.com/questions/686361/no-sound-through-headphones-while-speakers-work-fine?rq=1 thread] helps me to solve headphones problem. || Does not have Ethernet, but USB dongle works fine || Works out of the box || Works out of the box || Works out of box. TLP and PowerTop allows 7 - 8 hours battery life || Does not have a Modem || Comments: Laptop works beautifully with Linux, though PWM Fan control is not available (common issue on Zenbook range) ||<br />
|-<br />
! rowspan="2" | Model version<br />
! rowspan="2" | Arch Linux Install CD version<br />
! Video <br />
! Sound<br />
! Ethernet<br />
! Wireless<br />
! Bluetooth<br />
! Power management<br />
! Modem<br />
! Other<br />
! rowspan="2" | Remarks<br />
|-<br />
! colspan="8" | Hardware support<br />
|}</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=518096ASUS ROG GL702ZC2018-04-20T22:19:13Z<p>Bbaserdem: Fixed my formatting</p>
<hr />
<div>This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
== Backlight ==<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard_backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
== Fans ==<br />
<br />
Haven't checked yet, but seemingly works fine.<br />
<br />
== Troubleshooting ==<br />
<br />
Compton with default settings don't work.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=ASUS_ROG_GL702ZC&diff=518095ASUS ROG GL702ZC2018-04-20T22:17:54Z<p>Bbaserdem: Created page with "This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues. Category:Backlight This ASUS model comes with Radeon RX580...."</p>
<hr />
<div>This page is about the Laptop ROG Strix AMD laptop. Runs pretty good out of the box, with some minor issues.<br />
<br />
[[Category:Backlight]]<br />
<br />
This ASUS model comes with Radeon RX580. Backlight with {{ic|xbacklight}} will not work; since Radeon cards don't support RandR. The relevant module seems to be {{ic|amdgpu_bl0}}, and {{ic|asus::kbd_backlight}} for the keyboard backlight.<br />
<br />
You need to set the permissions for the {{ic|/sys/class/backlight/amdgpu_bl0/brightness}} and the keyboard version, as they are only editable by root. The page [[Keyboard_backlight]] suggests a systemd unit or a dbus daemon (that doesn't compile). You can write a DBus daemon yourself, or change permissions some other way. I suggest the following udev rule;<br />
<br />
{{hc|/etc/udev/rules.d/backlight.rules|<nowiki><br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="backlight", KERNEL=="amdgpu_bl0", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chgrp video /sys/class/backlight/%k/brightness"<br />
ACTION=="add", SUBSYSTEM=="leds", KERNEL=="asus::kbd_backlight", RUN+="/bin/chmod g+w /sys/class/backlight/%k/brightness"<br />
</nowiki>}}<br />
<br />
Then adding the user to the {{ic|video}} group. {{AUR|brightnessctl}} is a nice script that can increase and decrease brightness, which can be bound to the media keys.<br />
<br />
[[Category:Fans]]<br />
<br />
Haven't checked yet, but seemingly works fine.<br />
<br />
[[Categories:Troubleshooting]]<br />
<br />
Compton with default settings don't work.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=Qutebrowser&diff=511940Qutebrowser2018-02-25T05:37:13Z<p>Bbaserdem: I included a block website instruction, for users who would not want to go through the github page to figure out, or who wouldn't know python.</p>
<hr />
<div>{{Lowercase title}}<br />
[[Category:Web browser]]<br />
[[ja:Qutebrowser]]<br />
[https://github.com/qutebrowser/qutebrowser qutebrowser] is a keyboard-focused web browser based on Python and PyQt5.<br />
<br />
== Installation ==<br />
<br />
[[Install]] either the {{Pkg|qutebrowser}} or the {{AUR|qutebrowser-git}} package.<br />
<br />
== Basic usage ==<br />
<br />
Use {{ic|:}} to access the command prompt. You can use {{ic|Tab}} to auto-complete.<br />
<br />
On first usage of qutebrowser, a Quickstart page appears. It is later accessible via {{ic|:help}}. See the [https://qutebrowser.org/img/cheatsheet-big.png cheatsheet] for keyboard shortcuts.<br />
<br />
=== User configuration ===<br />
<br />
Qutebrowser can be configured via the UI, the qutebrowser command-line or a Python script. Qutebrowser's own documentation explains in detail how to configure qutebrowser with these different methods. To open qutebrowser's help system, type {{ic|:help}}. On the help page, choose {{ic|Configuring qutebrowser}}.<br />
<br />
To find out the paths where the configuration files will be located, open the special page {{ic|qute://version}}. On Arch Linux, this will typically be {{ic|$XDG_CONFIG_HOME/qutebrowser/}}. The configuration made in qutebrowser will be stored in {{ic|autoconfig.yml}} (which should not be touched by the user) while the user's Python script is {{ic|config.py}}.<br />
<br />
==== Configuration in Qutebrowser ====<br />
To set a single configuration item, you can simply type {{ic|:set}} followed by the name of the configuration item and the new value that you would like to set. For example, you could type<br />
<br />
:set auto_save.session true<br />
<br />
to open your previous tabs when you reopen qutebrowser.<br />
<br />
To open qutebrowser's UI settings page, type<br />
<br />
:set<br />
<br />
without further arguments. There, you can edit the different settings in the UI. When you are finished, type {{ic|:set}} again to store your configuration.<br />
<br />
For example, under {{ic|url.searchengines}} you can configure your search engines which are stored as a list of key-value pairs. When you have not changed this setting yet, this should look something like<br />
<br />
{"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>"}<br />
<br />
This configures DuckDuckGo as your default search engine while the placeholder {{ic|<nowiki>{}</nowiki>}} will be replaced by your search term. To add a shortcut for quickly searching the Arch Linux wiki, you could use<br />
<br />
{"DEFAULT": "<nowiki>https://duckduckgo.com/?q={}</nowiki>", "wa": "<nowiki>https://wiki.archlinux.org/?search={}</nowiki>"}<br />
<br />
Then, as described by the comment in the qutebrowser UI, you can search the Arch Linux wiki by typing {{ic|o wa <searchterm>}}. Notice that the arguments required to perform a search vary across search engines. For example, to set up Google, use {{ic|<nowiki>https://www.google.com/search?hl=en&q={}</nowiki>}}.<br />
<br />
=== Keybindings ===<br />
<br />
Keybindings reside in {{ic|$XDG_CONFIG_HOME/qutebrowser/keys.conf}}.<br />
<br />
You can edit the keybindings directly from the browser with the command {{ic|:bind ''key'' ''command''}} or you can edit them directly from the file. Notice that there are many, many keybinds already in place. If you notice a lag on one of your keybind it is because some other keybind is also starting with the same key.<br />
<br />
=== Video playback ===<br />
<br />
See [[Browser plugins#Multimedia playback]].<br />
<br />
== Tips and tricks ==<br />
<br />
=== Automatically enter login information ===<br />
<br />
You can use the [https://github.com/qutebrowser/qutebrowser/blob/master/misc/userscripts/qute-pass qute-pass] userscript to [https://i.imgur.com/KN3XuZP.gif automatically enter] login information stored in your [[Pass]] password-store. You will need a [[dmenu]]-compatible [[List_of_applications/Other#Application_launchers|application launcher]] and {{Pkg|python-tldextract}}. Set up a keybinding which executes {{ic|:spawn --userscript qute-pass}}.<br />
<br />
{{Style|The quote should be part of the userscript's {{ic|--help}} page if it's so prominent.}}<br />
<br />
To quote from the script's description:<br />
The domain of the site has to appear as a segment in the pass path, for example: "github.com/cryzed" or "websites/github.com". How the username and password are determined is freely configurable using the CLI arguments. The login information is inserted by emulating key events using qutebrowser's fake-key command in this manner: [USERNAME]<Tab>[PASSWORD], which is compatible with almost all login forms.<br />
<br />
<br />
To further clarify, the pass-structure that is used by default should look something like this:<br />
<br />
{{ hc| user@computer$ pass |<br />
Password Store <br />
├── example.site1.com <br />
│  └── username <br />
├── example.site2.com <br />
│  └── username1 <br />
│  └── username2 <br />
}}<br />
<br />
This means is that each website is a directory in your ~/.password-store folder. Within each website-named directory is where the files are titled username.gpg, username2.pgp, etc. and each file contains the password associated with each username for the website. For those of you migrating from Firefox, a [https://github.com/johnabs/firefox_decrypt modified version of firefox_decrypt] should migrate things in this format.<br />
<br />
<br />
The userscript provides many options to accomodate most workflows and special circumstances (such as only wanting to insert the password or the regular method of inserting the username and password not working).<br />
<br />
=== Turn on spell checking ===<br />
<br />
First, download the appropriate dictionary to {{ic|/usr/share/qt5/qtwebengine_dicionaries/}} from [https://chromium.googlesource.com/chromium/deps/hunspell_dictionaries.git/+/master/]. The file will have a suffix of {{ic|.bdic}}. For example, for English (US):<br />
<br />
# wget https://chromium.googlesource.com/chromium/deps/hunspell_dictionaries.git/+/master/en-US-8-0.bdic?format=TEXT -o /usr/share/qt5/qtwebengine_dictionaries/en-US-8-0.bdic<br />
<br />
Then set the following in qutebrowser:<br />
<br />
:set spellcheck.languages ["en-US"]<br />
<br />
=== Minimize fingerprinting ===<br />
<br />
Websites may be able to identify you based on combining information on screen size, user-agent, HTTP_ACCEPT headers, and more. See [https://panopticlick.eff.org/] for more information and to test the uniqueness of your browser. Below are a few steps that can be taken to make your qutebrowser installation more "generic".<br />
<br />
Additionally see [[Firefox/Privacy#Configuration tweaks]] for more ideas.<br />
<br />
==== Set a common user-agent ====<br />
<br />
Several user agents are available as options when using {{ic|set content.headers.user_agent}}. Another, possibly more generic user-agent is:<br />
<br />
Mozilla/5.0 (Windows NT 6.1; rv:52.0) Gecko/20100101 Firefox/52.0<br />
<br />
{{Note|<br />
* Changing {{ic|Linux x86_64}} to a non-Linux platform may make your browser more unique, since websites can also gather your platform type via Javascript, and this setting cannot be changed in qutebrowser.<br />
* Changing your user-agent away from the default will prevent some websites from working properly.}}<br />
<br />
==== Set a common HTTP_ACCEPT header ====<br />
<br />
The following is a common HTTP_ACCEPT header (Firefox default). Simply type the following commands at the prompt<br />
<br />
set content.headers.accept_language en-US,en;q=0.5<br />
set content.headers.custom '{"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"}'<br />
<br />
==== Disable reading from canvas ====<br />
<br />
This option is not currently available in qutebrowser other than by specifying it on the commandline like so:<br />
<br />
$ qutebrowser --qt-flag disable-reading-from-canvas<br />
<br />
See [https://github.com/qutebrowser/qutebrowser/issues/2235 issue #2235] for more information.<br />
<br />
{{Note|Some websites depend on canvas reading for content rendering and other functionality. Adding this option may cause them to not work properly [https://github.com/qutebrowser/qutebrowser/issues/2908].}}<br />
<br />
==== Disable WebGL ====<br />
<br />
Set {{ic|content.webgl}} to {{ic|false}} to disable WebGL.<br />
<br />
=== dwb-like session handling ===<br />
<br />
To have qutebrowser handle sessions more like in [[dwb]] with the {{ic|--restore}} option (multiple simultaneously active sessions), you can use [https://github.com/ayekat/dotfiles/blob/master/bin/qutebrowser this wrapper script]. It uses {{ic|--basedir}} to separate data, cache and runtime for each session, while keeping the configuration shared.<br />
<br />
=== Disable websites ===<br />
<br />
Put {{ic|c.content.host_blocking.lists.append( str(config.configdir) + "/blockedHosts")}} in your {{ic|config.py}}, and create a {{ic|blockedHosts}} file in the same directory as the config file. Enter websites you want to block one by one; {{ic|127.0.0.1 www.youtube.com}} for example. This will keep the built-in adblock list while adding the websites in. Restart qutebrowser, and run {{ic|:adblock-update}}.<br />
<br />
== See also ==<br />
<br />
* [https://github.com/qutebrowser/qutebrowser GitHub repository]<br />
* [https://qutebrowser.org/ Homepage]<br />
* [https://bbs.archlinux.org/viewtopic.php?id=191076 BBS thread]<br />
* [https://bitbucket.org/jasonwryan/shiv/src/tip/.config/qutebrowser/config.py New config example]</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=OpenFOAM&diff=506818OpenFOAM2018-01-10T17:44:47Z<p>Bbaserdem: /* Paraview not installed */ Typo on command</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:OpenFOAM]]<br />
The OpenFOAM® (Open Field Operation and Manipulation) CFD Toolbox is a free, open source CFD software package produced by OpenCFD Ltd. It has a large user base across most areas of engineering and science, from both commercial and academic organisations. OpenFOAM has an extensive range of features to solve anything from complex fluid flows involving chemical reactions, turbulence and heat transfer, to solid dynamics and electromagnetics. It includes tools for meshing, notably snappyHexMesh, a parallelised mesher for complex CAD geometries, and for pre- and post-processing. Almost everything (including meshing, and pre- and post-processing) runs in parallel as standard, enabling users to take full advantage of computer hardware at their disposal.<br />
<br />
For more information on OpenFOAM and the OpenFOAM Foundation, please see http://www.openfoam.com and http://www.openfoam.org respectively.<br />
<br />
== Basic installation ==<br />
<br />
If you do not plan on doing development tasks with OpenFOAM, there is an updated version of the program available in the [[AUR]] package {{AUR|openfoam}} and git versions {{AUR|openfoam2.4-git}} or {{AUR|openfoam3.0-git}}. For most users, this will be everything needed to get an installation up and running.<br />
<br />
An '''openfoam3.0.1''' package is also available from the unofficial [[Unofficial user repositories#home_Minerva_W_Science_Arch_Extra|home_Minerva_W_Science_Arch_Extra]] repository. Development and older versions are planned to be added as of April 2016.<br />
<br />
== Development installation ==<br />
<br />
For installation of OpenFOAM in a development environment, the process is fairly straight forward on Arch Linux. The basic steps are as follows:<br />
<br />
# Obtain source files from OpenFOAM<br />
# Prepare build directory<br />
# Create Preference File and Set Environment Variables for your installation<br />
# Compile OpenFOAM sources<br />
# Test OpenFOAM installation<br />
<br />
=== Prerequisites ===<br />
<br />
* {{Pkg|openmpi}}<br />
* {{AUR|paraview}}<br />
* {{AUR|parmetis}}<br />
* {{AUR|scotch}}<br />
* {{Pkg|boost-libs}}<br />
* {{Pkg|boost}}<br />
<br />
=== Obtain source files ===<br />
<br />
==== Latest stable release ====<br />
<br />
{{Expansion|TODO}}<br />
<br />
=== Environment variables ===<br />
<br />
Paste the following code into your ~/.bashrc file. Whenever you want to run OpenFOAM you just have to type of20x to initialize the environment.<br />
<br />
{{bc|# OpenFOAM Install<br />
export FOAM_INST_DIR&#61;'$HOME/.OpenFOAM'<br />
alias of20x&#61;'source $FOAM_INST_DIR/OpenFOAM-2.0.x/etc/bashrc'}}<br />
<br />
==Troubleshooting==<br />
<br />
===zsh===<br />
<br />
Some things don't work straightforward if you are not using bash. In the case of zsh, you will need the {{Pkg|bash-completion}} package, and add the following to your {{ic|.zshrc}} for the OpenFOAM scripts to work.<br />
<br />
{{bc|autoload bashcompinit<br />
bashcompinit}}<br />
<br />
Add {{ic|1=export FOAM_INST_DIR=/opt/OpenFOAM}} to your {{ic|.zshenv}} and {{ic|1=alias ofoam="source ${FOAM_INST_DIR}/OpenFOAM-5.0/etc/bashrc"}} to your {{ic|.zshrc}}. <br />
<br />
===Paraview not installed===<br />
<br />
This happens because the dependencies are installed as separate packages, and not in the third-party apps directory of OpenFOAM. Either;<br />
<br />
* Add {{ic|1=alias paraFoam='paraFoam -builtin'}} to your {{ic|/opt/OpenFOAM/Open-FOAM-X.X/etc/bashrc}}.<br />
* For each project, {{ic|touch `echo "${PWD##*/}"`.foam}} and then open the touched file from paraview.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=OpenFOAM&diff=506773OpenFOAM2018-01-09T22:37:41Z<p>Bbaserdem: /* zsh */ Fixed it again</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:OpenFOAM]]<br />
The OpenFOAM® (Open Field Operation and Manipulation) CFD Toolbox is a free, open source CFD software package produced by OpenCFD Ltd. It has a large user base across most areas of engineering and science, from both commercial and academic organisations. OpenFOAM has an extensive range of features to solve anything from complex fluid flows involving chemical reactions, turbulence and heat transfer, to solid dynamics and electromagnetics. It includes tools for meshing, notably snappyHexMesh, a parallelised mesher for complex CAD geometries, and for pre- and post-processing. Almost everything (including meshing, and pre- and post-processing) runs in parallel as standard, enabling users to take full advantage of computer hardware at their disposal.<br />
<br />
For more information on OpenFOAM and the OpenFOAM Foundation, please see http://www.openfoam.com and http://www.openfoam.org respectively.<br />
<br />
== Basic installation ==<br />
<br />
If you do not plan on doing development tasks with OpenFOAM, there is an updated version of the program available in the [[AUR]] package {{AUR|openfoam}} and git versions {{AUR|openfoam2.4-git}} or {{AUR|openfoam3.0-git}}. For most users, this will be everything needed to get an installation up and running.<br />
<br />
An '''openfoam3.0.1''' package is also available from the unofficial [[Unofficial user repositories#home_Minerva_W_Science_Arch_Extra|home_Minerva_W_Science_Arch_Extra]] repository. Development and older versions are planned to be added as of April 2016.<br />
<br />
== Development installation ==<br />
<br />
For installation of OpenFOAM in a development environment, the process is fairly straight forward on Arch Linux. The basic steps are as follows:<br />
<br />
# Obtain source files from OpenFOAM<br />
# Prepare build directory<br />
# Create Preference File and Set Environment Variables for your installation<br />
# Compile OpenFOAM sources<br />
# Test OpenFOAM installation<br />
<br />
=== Prerequisites ===<br />
<br />
* {{Pkg|openmpi}}<br />
* {{AUR|paraview}}<br />
* {{AUR|parmetis}}<br />
* {{AUR|scotch}}<br />
* {{Pkg|boost-libs}}<br />
* {{Pkg|boost}}<br />
<br />
=== Obtain source files ===<br />
<br />
==== Latest stable release ====<br />
<br />
{{Expansion|TODO}}<br />
<br />
=== Environment variables ===<br />
<br />
Paste the following code into your ~/.bashrc file. Whenever you want to run OpenFOAM you just have to type of20x to initialize the environment.<br />
<br />
{{bc|# OpenFOAM Install<br />
export FOAM_INST_DIR&#61;'$HOME/.OpenFOAM'<br />
alias of20x&#61;'source $FOAM_INST_DIR/OpenFOAM-2.0.x/etc/bashrc'}}<br />
<br />
==Troubleshooting==<br />
<br />
===zsh===<br />
<br />
Some things don't work straightforward if you are not using bash. In the case of zsh, you will need the {{Pkg|bash-completion}} package, and add the following to your {{ic|.zshrc}} for the OpenFOAM scripts to work.<br />
<br />
{{bc|autoload bashcompinit<br />
bashcompinit}}<br />
<br />
Add {{ic|1=export FOAM_INST_DIR=/opt/OpenFOAM}} to your {{ic|.zshenv}} and {{ic|1=alias ofoam="source ${FOAM_INST_DIR}/OpenFOAM-5.0/etc/bashrc"}} to your {{ic|.zshrc}}. <br />
<br />
===Paraview not installed===<br />
<br />
This happens because the dependencies are installed as separate packages, and not in the third-party apps directory of OpenFOAM. Either;<br />
<br />
* Add {{ic|1=alias paraFoam='paraFoam -builtin'}} to your {{ic|/opt/OpenFOAM/Open-FOAM-X.X/etc/bashrc}}.<br />
* For each project, {{ic|touch `echo "${PMD##*/}"`.foam}} and then open the touched file from paraview.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=OpenFOAM&diff=506772OpenFOAM2018-01-09T22:37:16Z<p>Bbaserdem: Fixed my previous edit</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:OpenFOAM]]<br />
The OpenFOAM® (Open Field Operation and Manipulation) CFD Toolbox is a free, open source CFD software package produced by OpenCFD Ltd. It has a large user base across most areas of engineering and science, from both commercial and academic organisations. OpenFOAM has an extensive range of features to solve anything from complex fluid flows involving chemical reactions, turbulence and heat transfer, to solid dynamics and electromagnetics. It includes tools for meshing, notably snappyHexMesh, a parallelised mesher for complex CAD geometries, and for pre- and post-processing. Almost everything (including meshing, and pre- and post-processing) runs in parallel as standard, enabling users to take full advantage of computer hardware at their disposal.<br />
<br />
For more information on OpenFOAM and the OpenFOAM Foundation, please see http://www.openfoam.com and http://www.openfoam.org respectively.<br />
<br />
== Basic installation ==<br />
<br />
If you do not plan on doing development tasks with OpenFOAM, there is an updated version of the program available in the [[AUR]] package {{AUR|openfoam}} and git versions {{AUR|openfoam2.4-git}} or {{AUR|openfoam3.0-git}}. For most users, this will be everything needed to get an installation up and running.<br />
<br />
An '''openfoam3.0.1''' package is also available from the unofficial [[Unofficial user repositories#home_Minerva_W_Science_Arch_Extra|home_Minerva_W_Science_Arch_Extra]] repository. Development and older versions are planned to be added as of April 2016.<br />
<br />
== Development installation ==<br />
<br />
For installation of OpenFOAM in a development environment, the process is fairly straight forward on Arch Linux. The basic steps are as follows:<br />
<br />
# Obtain source files from OpenFOAM<br />
# Prepare build directory<br />
# Create Preference File and Set Environment Variables for your installation<br />
# Compile OpenFOAM sources<br />
# Test OpenFOAM installation<br />
<br />
=== Prerequisites ===<br />
<br />
* {{Pkg|openmpi}}<br />
* {{AUR|paraview}}<br />
* {{AUR|parmetis}}<br />
* {{AUR|scotch}}<br />
* {{Pkg|boost-libs}}<br />
* {{Pkg|boost}}<br />
<br />
=== Obtain source files ===<br />
<br />
==== Latest stable release ====<br />
<br />
{{Expansion|TODO}}<br />
<br />
=== Environment variables ===<br />
<br />
Paste the following code into your ~/.bashrc file. Whenever you want to run OpenFOAM you just have to type of20x to initialize the environment.<br />
<br />
{{bc|# OpenFOAM Install<br />
export FOAM_INST_DIR&#61;'$HOME/.OpenFOAM'<br />
alias of20x&#61;'source $FOAM_INST_DIR/OpenFOAM-2.0.x/etc/bashrc'}}<br />
<br />
==Troubleshooting==<br />
<br />
==zsh==<br />
<br />
Some things don't work straightforward if you are not using bash. In the case of zsh, you will need the {{Pkg|bash-completion}} package, and add the following to your {{ic|.zshrc}} for the OpenFOAM scripts to work.<br />
<br />
{{bc|autoload bashcompinit<br />
bashcompinit}}<br />
<br />
Add {{ic|1=export FOAM_INST_DIR=/opt/OpenFOAM}} to your {{ic|.zshenv}} and {{ic|1=alias ofoam="source ${FOAM_INST_DIR}/OpenFOAM-5.0/etc/bashrc"}} to your {{ic|.zshrc}}. <br />
<br />
===Paraview not installed===<br />
<br />
This happens because the dependencies are installed as separate packages, and not in the third-party apps directory of OpenFOAM. Either;<br />
<br />
* Add {{ic|1=alias paraFoam='paraFoam -builtin'}} to your {{ic|/opt/OpenFOAM/Open-FOAM-X.X/etc/bashrc}}.<br />
* For each project, {{ic|touch `echo "${PMD##*/}"`.foam}} and then open the touched file from paraview.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=OpenFOAM&diff=506771OpenFOAM2018-01-09T22:36:12Z<p>Bbaserdem: Added some fixes for users with zsh</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:OpenFOAM]]<br />
The OpenFOAM® (Open Field Operation and Manipulation) CFD Toolbox is a free, open source CFD software package produced by OpenCFD Ltd. It has a large user base across most areas of engineering and science, from both commercial and academic organisations. OpenFOAM has an extensive range of features to solve anything from complex fluid flows involving chemical reactions, turbulence and heat transfer, to solid dynamics and electromagnetics. It includes tools for meshing, notably snappyHexMesh, a parallelised mesher for complex CAD geometries, and for pre- and post-processing. Almost everything (including meshing, and pre- and post-processing) runs in parallel as standard, enabling users to take full advantage of computer hardware at their disposal.<br />
<br />
For more information on OpenFOAM and the OpenFOAM Foundation, please see http://www.openfoam.com and http://www.openfoam.org respectively.<br />
<br />
== Basic installation ==<br />
<br />
If you do not plan on doing development tasks with OpenFOAM, there is an updated version of the program available in the [[AUR]] package {{AUR|openfoam}} and git versions {{AUR|openfoam2.4-git}} or {{AUR|openfoam3.0-git}}. For most users, this will be everything needed to get an installation up and running.<br />
<br />
An '''openfoam3.0.1''' package is also available from the unofficial [[Unofficial user repositories#home_Minerva_W_Science_Arch_Extra|home_Minerva_W_Science_Arch_Extra]] repository. Development and older versions are planned to be added as of April 2016.<br />
<br />
== Development installation ==<br />
<br />
For installation of OpenFOAM in a development environment, the process is fairly straight forward on Arch Linux. The basic steps are as follows:<br />
<br />
# Obtain source files from OpenFOAM<br />
# Prepare build directory<br />
# Create Preference File and Set Environment Variables for your installation<br />
# Compile OpenFOAM sources<br />
# Test OpenFOAM installation<br />
<br />
=== Prerequisites ===<br />
<br />
* {{Pkg|openmpi}}<br />
* {{AUR|paraview}}<br />
* {{AUR|parmetis}}<br />
* {{AUR|scotch}}<br />
* {{Pkg|boost-libs}}<br />
* {{Pkg|boost}}<br />
<br />
=== Obtain source files ===<br />
<br />
==== Latest stable release ====<br />
<br />
{{Expansion|TODO}}<br />
<br />
=== Environment variables ===<br />
<br />
Paste the following code into your ~/.bashrc file. Whenever you want to run OpenFOAM you just have to type of20x to initialize the environment.<br />
<br />
{{bc|# OpenFOAM Install<br />
export FOAM_INST_DIR&#61;'$HOME/.OpenFOAM'<br />
alias of20x&#61;'source $FOAM_INST_DIR/OpenFOAM-2.0.x/etc/bashrc'}}<br />
<br />
===zsh===<br />
<br />
Some things don't work straightforward if you are not using bash. In the case of zsh, you will need the {{Pkg|bash-completion}} package, and add the following to your {{ic|.zshrc}} for the OpenFOAM scripts to work.<br />
<br />
{{bc|autoload bashcompinit<br />
bashcompinit}}<br />
<br />
Add {{ic|1=export FOAM_INST_DIR=/opt/OpenFOAM}} to your {{ic|.zshenv}} and {{ic|1=alias ofoam="source ${FOAM_INST_DIR}/OpenFOAM-5.0/etc/bashrc"}} to your {{ic|.zshrc}}. <br />
<br />
==Troubleshooting==<br />
<br />
===Paraview not installed===<br />
<br />
This happens because the dependencies are installed as separate packages, and not in the third-party apps directory of OpenFOAM. Either;<br />
<br />
* Add {{ic|1=alias paraFoam='paraFoam -builtin'}} to your {{ic|/opt/OpenFOAM/Open-FOAM-X.X/etc/bashrc}}.<br />
* For each project, {{ic|touch `echo "${PMD##*/}"`.foam}} and then open the touched file from paraview.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=MATLAB&diff=492988MATLAB2017-10-12T12:24:31Z<p>Bbaserdem: /* Blank/grey UI when using WM (non-reparenting window manager) */ Fixed wording and added another solution that might work.</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:Matlab]]<br />
{{Related articles start}}<br />
{{Related|Octave}}<br />
{{Related|Sage-mathematics}}<br />
{{Related|Mathematica}}<br />
{{Related articles end}}<br />
{{Poor writing|unnecessarily verbose}}<br />
From the [http://www.mathworks.com/products/matlab/ official website]:<br />
<br />
:''MATLAB is a high-level language and interactive environment for numerical computation, visualization, and programming. Using MATLAB, you can analyze data, develop algorithms, and create models and applications. The language, tools, and built-in math functions enable you to explore multiple approaches and reach a solution faster than with spreadsheets or traditional programming languages, such as C/C++ or Java.''<br />
<br />
== Overview ==<br />
<br />
MATLAB is proprietary software produced by The MathWorks and requires a license to obtain, install, and activate. New versions of MATLAB are released twice a year,<br />
release names are composed of {{ic|R}}, the year of the release and {{ic|a}} or {{ic|b}}.<br />
Since R2012b MATLAB has only been available for 64-bit Linux. Arch Linux is not officially supported.<br />
[http://www.mathworks.co.uk/support/sysreq/current_release/index.html]<br />
<br />
== Installation ==<br />
<br />
A complete copy of the MATLAB software must be obtained before it can be installed. The MATLAB software is available to licenses holders on both a DVD and through the [http://www.mathworks.com The MathWorks website]. In addition to the software a file installation key is required for installation. It is possible to install MATLAB either with the {{aur|matlab}} package from the [[AUR]] or from the MATLAB installation software directly. The advantage of the {{aur|matlab}} package is that it manages dependencies and some of the nuances of the installation process while installing directly from the MATLAB installation software can be done by regular users to their home directories and works for any release of MATLAB (the {{aur|matlab}} package only works for releases including and after R2010b).<br />
<br />
=== Installing from the MATLAB installation software ===<br />
<br />
The MATLAB installation software is self contained and does not require any additional packages to install in silent mode. To install with the GUI a working [[Xorg]] graphical display is necessary. The installation is handled by the {{ic|install}} script. You can run the script as root to install MATLAB system-wide or your user to install it only for you.<br />
<br />
MATLAB 2016a and earlier is not compatible with {{Pkg|ncurses}} 6, so you must install the {{AUR|ncurses5-compat-libs}} package. See [[#Segmentation fault on startup]] for more info.<br />
<br />
During the installation, you are asked if you want symlinks to be created. If you did not choose to do so, you can now manually create a symlink in {{ic|/usr/local/bin}} to make it easier to launch in terminal:<br />
<br />
# ln -s /{MATLAB}/bin/matlab /usr/local/bin<br />
<br />
==== Desktop entry ====<br />
<br />
Optionally create a [[desktop entry]]. The MIME type of MATLAB files is {{ic|text/x-matlab}}.<br />
<br />
Start {{ic|matlab}} with:<br />
<br />
* {{ic|-desktop}} to run Matlab without a terminal.<br />
* {{ic|-nosplash}} to prevent the splash screen from showing up.<br />
<br />
In order for icons to appear correctly {{ic|StartupWMClass}} needs to be set in the desktop entry. To find it out start MATLAB, run {{ic|xprop {{!}} grep WM_CLASS}} and select the MATLAB window.<br />
<br />
=== Installing from the AUR package ===<br />
<br />
The EULA for the proprietary MATLAB software is restrictive. The {{aur|matlab}} package from the [[AUR]] is designed to allow MATLAB to be integrated into and managed by Arch. The package should be built on the system on which it is going to be installed and the package should be deleted from the installation location and the [[Pacman]] cache following installation. Distributing the package is a clear violation of the EULA.<br />
<br />
The {{aur|matlab}} package from the [[AUR]] defaults to building a package for the most recent 64-bit release of MATLAB, although the PKGBUILD supports MATLAB releases from R2010b and even the installation of multiple releases simultaneous. The PKGBUILD defaults to installing all toolboxes that the file identification key allows, however, the PKGBUILD can be edited to include only a subset of the toolboxes. The selection of the toolboxes must be finalized at the time of package creation due to DRM policies put in place by The MathWorks. The {{aur|matlab}} package from the [[AUR]] requires that both the MATLAB installation software and the file installation key are available in the source directory. The file installation key must be in a file called {{ic|matlab.fik}} and the installation software must be in an iso file called {{ic|matlab.iso}}. Once the iso file and file installation key are created, the MATLAB package can be created and install as usual.<br />
<br />
For MATLAB releases between r2010b and r2011a the contents of the iso file must include: {{ic|./archives/}}, {{ic|./bin/}}, {{ic|./etc/}}, {{ic|./help/}}, {{ic|./java/}}, {{ic|./activate.ini}}, {{ic|./install}}, and {{ic|./installer_input.txt}}. If the MATLAB download agent is used to download the installation software, then the iso file can be trivially created by simply running {{ic|mkisofs -r -o}} on the download directory.<br />
<br />
For MATLAB releases including and after r2011b the contents of the iso file must include: {{ic|./archives/}}, {{ic|./bin/}}, {{ic|./etc/}}, {{ic|./help/}}, {{ic|./java/}}, {{ic|./activate.ini}}, {{ic|./install}}, and {{ic|./installer_input.txt}}. For version before r2014a, the MATLAB download agent could download all the required files and the iso file could be trivially created by simply running {{ic|mkisofs -r -o}} on the download directory. For MATLAB releases including and after r2014a the MATLAB download agent only downloads the MATLAB installer. The MATLAB installer then needs to be run to downloaded the MATLAB software and toolboxes. Therefore, a two step process is required to generate this iso file with the MATLAB download agent. First, you download and run the MATLAB installer to install MATLAB in a temporary directory. This process downloads the MATLAB software and toolboxes by default to {{ic|~/Downloads/MathWorks}} (this can be changed by passing the flag {{ic|-downloadFolder /path/to/directory}}). It is actually possible quit the MATLAB installer once the software and toolboxes are downloaded. Once the software and toolboxes are downloaded the required iso file can be created by merging the installer directory (containing above mentioned files) and the download directory (containing {{ic|./archives/}}), and then running {{ic|mkisofs -r -o}} on the resulting directory.<br />
<br />
== Activation ==<br />
<br />
In order to run MATLAB it requires a license file to be installed. The license file can be generated with {{ic|$MATLABROOT/bin/activate_matlab.sh}} or downloaded from [http://www.mathworks.com MATLAB] directly. <br />
<br />
=== R2013b and earlier ===<br />
<br />
Up to and including R2013b the license file was linked to the MAC address of eth0. This causes problems with the [[Network_configuration#Device_names|Predictable Network Interface Names]] used by Arch Linux. It is possible to disable predictable network interface names by adding {{ic|1=net.ifnames=0}} in your kernel command line or by creating a udev rule file<br />
<br />
# ln -s /dev/null /etc/udev/rules.d/80-net-setup-link.rules<br />
<br />
It is also possible to [[Network_configuration#Change_device_name|change the name of a device]], but changing the name to eth0 can result in race conditions between the kernel and udev during boot. Another solution is to create a dummy network interface named eth0 with the MAC address linked to the license file. First, get that MAC address using {{ic|ip link}}. Next, create the following file:<br />
<br />
{{hc|/etc/systemd/system/matlab.licensing.service|<nowiki><br />
[Unit]<br />
Description=Dummy network interface for MATLAB<br />
Requires=systemd-modules-load.service<br />
<br />
[Service]<br />
Type=oneshot<br />
ExecStart=/sbin/ip link set dev dummy0 name eth0<br />
ExecStart=/sbin/ip link set dev eth0 address 00:00:00:00:00:00<br />
<br />
[Install]<br />
WantedBy=multi-user.target<br />
</nowiki>}}<br />
<br />
Replace 00:00:00:00:00:00 with the MAC address linked to the license file.<br />
<br />
Then make the script run on boot:<br />
<br />
# systemctl enable matlab.licensing<br />
<br />
Finally, set the dummy module to load on boot by creating the following file:<br />
<br />
{{hc|/etc/modules-load.d/dummy.conf|<nowiki>dummy</nowiki>}}<br />
<br />
== Configuration ==<br />
<br />
=== Java ===<br />
<br />
The MATLAB software is bundled with a JVM and therefore it is not necessary to install [[Java]]. The JVM version bundled with MATLAB typically lags behind {{pkg|jre7-openjdk}} from the [[official repositories]] and it is possible, although not required, to use the {{ic|MATLAB_JAVA}} environment variable to specify the path of an alternative JRE. For example, to specify the {{pkg|jre7-openjdk}} JRE and check the resulting version of Java, do:<br />
<br />
$ MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre matlab -nodesktop -nosplash -r "version -java, exit" | grep Java<br />
<br />
{{Accuracy|overly specific, yet no references to claimed behaviour}}<br />
<br />
Using alternative JRE would often solve some long-standing problems, such as the extra "{{ic|MEvent. CASE!}}" string when doing two-finger scrolling using touchpad. Another problem that can be solved in this way is the ugly, limited fonts provided by default, especially for some Chinese characters.<br />
<br />
=== OpenGL acceleration ===<br />
<br />
MATLAB can take advantage of hardware based 2D and 3D OpenGL acceleration. Support for hardware acceleration needs to be configured outside of MATLAB. Appropriate [[video drivers]] need to be installed along with the OpenGL utility library {{Pkg|glu}} package. If X11 forwarding is being used, the video drivers need to be installed on both the client and server. To check if MATLAB is making use of hardware based OpenGL acceleration run:<br />
<br />
$ matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If "software rendering" is not "false", then there is a problem with your hardware acceleration. If this is the case make sure OpenGL is configured correctly on the system. This can be done with the {{ic|glxinfo}} program from the {{Pkg|mesa-demos}} package:<br />
<br />
$ glxinfo | grep "direct rendering"<br />
<br />
If "direct rendering" is not "yes", then there is likely a problem with your system configuration.<br />
<br />
If glxinfo works but not matlab, you can try to run:<br />
$ export LD_PRELOAD=/usr/lib/libstdc++.so; export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/; matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If its works, you can edit Matlab launcher script to add:<br />
<br />
export LD_PRELOAD=/usr/lib/libstdc++.so<br />
export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/<br />
<br />
=== Fonts for figures ===<br />
<br />
{{Note| This section only applies to R2014a and earlier as starting with R2014b MATLAB uses True Type Fonts. So as long as {{ic|fc-match Helvetica}} returns a font, figure fonts should work as expected.}}<br />
<br />
While MATLAB can be run in a text only mode, it also provides advanced graphics capabilities. To confirm that MATLAB is making use of the system fonts run:<br />
<br />
$ matlab -nodesktop -nosplash -r "xlabel('BIG FONT', 'FontSize', 42); ylabel('small font', 'FontSize', 12); pause; exit" > /dev/null<br />
<br />
This should produce a MATLAB figure with "BIG FONT" in a large font on the abscissa and "small font" in a small font on the ordinate. If "BIG FONT" and "small font" are both the same size, refer to [[Xorg#Program_requests_.22font_.27.28null.29.27.22|Xorg fonts]] to confirm that the correct the bitmap font package (either {{Pkg|xorg-fonts-100dpi}} or {{Pkg|xorg-fonts-75dpi}} from the [[official repositories]]) is installed on your system.<br />
<br />
=== Sound ===<br />
<br />
To confirm that MATLAB is able to use the default soundcard to present sounds run:<br />
<br />
$ matlab -nodesktop -nosplash -r "load handel; sound(y, Fs); pause(length(y)/Fs); exit" > /dev/null<br />
<br />
This should play an except from Handel's "Hallelujah Chorus." If this fails make sure [[ALSA]] is properly configured. This can be done with the {{ic|speaker-test}} program from the {{Pkg|alsa-utils}} package from the [[official repositories]]:<br />
<br />
$ speaker-test<br />
<br />
If you do not hear anything, then there is likely a problem with your system configuration.<br />
<br />
=== GPU computing ===<br />
<br />
MATLAB can take advantage of [http://www.mathworks.co.uk/discovery/matlab-gpu.html CUDA enabled GPUs] to speed up applications. In order to take advantage of a supported GPU install the {{Pkg|nvidia}}, {{Pkg|nvidia-utils}}, {{Pkg|ocl-icd}}, {{Pkg|opencl-nvidia}}, and {{Pkg|cuda}} packages from the [[official repositories]]. To check if MATLAB is able to utilize the GPU run:<br />
<br />
$ matlab -nodesktop -nosplash -r "x=rand(10, 'single'); g=gpuArray(x); Success=isequal(gather(g), x), exit" | sed -ne '/Success =/,$p'<br />
<br />
=== Install supported compilers ===<br />
<br />
In order to access the full functionality of MATLAB (e.g., to use Simulink, Builder JA, and MEX-file compilation), supported versions of the {{ic|gcc}}, {{ic|g++}}, {{ic|gfortran}}, and {{ic|jdk}} compilers must be installed. Details about the supported compilers for the [http://www.mathworks.com/support/compilers/current_release/index.html?sec=glnxa64 current release] and [http://www.mathworks.com/support/sysreq/previous_releases.html previous releases] are available online. Many of the supported {{ic|gcc}}, {{ic|g++}}, {{ic|jdk}} compiler versions for past MATLAB releases are available from the [[AUR]] (e.g., {{AUR|gcc43}}, {{AUR|gcc44}}, {{AUR|gcc47}}, {{AUR|gcc49}}and {{AUR|jdk6}}), while past versions of the {{ic|gfortran}} compilers are not packaged.<br />
<br />
To use previous versions of the the {{ic|gcc}}, {{ic|g++}}, and {{ic|gfortran}} compilers with MEX files, edit {{ic|${MATLAB}/bin/mexopts.sh}} and replace all occurrences of {{ic|<nowiki>CC='gcc'</nowiki>}} with {{ic|<nowiki>CC='gcc-4.X'</nowiki>}}, {{ic|<nowiki>CXX='g++'</nowiki>}} with {{ic|<nowiki>CXX='g++-4.X'</nowiki>}}, and {{ic|<nowiki>FC='gfortran'</nowiki>}} with {{ic|<nowiki>FC='gfortran-4.X'</nowiki>}}, where {{ic|X}} is the compiler version appropriate for the particular MATLAB release.<br />
<br />
{{Note|Though, it's no officially supported, one could still use higher version of compiler, and ignore the warnings.}}<br />
<br />
=== Help browser ===<br />
<br />
The help browser uses valuable slots in the dynamic thread vector and causes competition with core functionality provided by libraries like the BLAS that also depend on the dynamic thread vector. The help browser can be configured to use fewer slots in the dynamic thread vector with<br />
<br />
>> webutils.htmlrenderer('basic');<br />
<br />
This is a persistent change and to reverse it use<br />
<br />
>> webutils.htmlrenderer('default');<br />
<br />
=== Garbled Interface ===<br />
<br />
export J2D_D3D=false<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
== Troubleshooting ==<br />
<br />
=== Static TLS errors ===<br />
<br />
MATLAB has a number of libraries that have been compiled with static thread local storage (TLS) including the help broswer {{ic|doc}} and the BLAS libraries. For example,<br />
<br />
>> doc('help');<br />
>> ones(10)*randn(10);<br />
Error using * <br />
BLAS loading error:<br />
dlopen: cannot load any more object with static TLS<br />
<br />
is related to the bugs:<br />
<br />
* [http://www.mathworks.de/support/bugreports/961964 961964] for which patched libraries are available from [http://www.mathworks.de/support/bugreports/license/accept_license/5730?fname=attachment_961964_12b_13a_13b_14a_glnxa64_2014-01-30.zip&geck_id=961964 MathWorks]<br />
* [http://www.mathworks.com/support/bugreports/1003952 1003952] for which workarounds exist<br />
<br />
A more general solution of recompiling {{ic|glibc}} has also been suggested. [http://stackoverflow.com/a/19468365/2787723]<br />
<br />
=== MATLAB crashes when displaying graphics ===<br />
<br />
To identify this error, start MATLAB with<br />
<br />
LIBGL_DEBUG=verbose matlab<br />
<br />
from the terminal and try to collect OpenGL information with {{ic|opengl info}} from the MATLAB command prompt. If it crashes again and there is an output line like <br />
<br />
libGL error: dlopen /usr/lib/xorg/modules/dri/swrast_dri.so failed <br />
(/usr/local/MATLAB/R2011b/bin/glnxa64/../../sys/os/glnxa64/libstdc++.so.6: <br />
version `GLIBCXX_3.4.15' not found (required by /usr/lib/xorg/modules/dri/swrast_dri.so))<br />
<br />
then the problem is that MATLAB uses its own GNU C++ library, which is an older version than the up-to-date version on your Archlinux system. Make MATLAB use the current C++ library for your system by<br />
<br />
cd /usr/local/MATLAB/R(your release)/sys/os/glnxa64<br />
sudo unlink libstdc++.so.6<br />
sudo ln -s /usr/lib/libstdc++.so.6<br />
<br />
If MATLAB still crashes or corrupts graphics (during startup or when plotting), make sure Java's 2D OpenGL rendering is disabled.<br />
The environment variable {{ic|_JAVA_OPTIONS}} should not contain {{ic|1=-Dsun.java2d.opengl=true}}.<br />
<br />
=== Blank/grey UI when using WM (non-reparenting window manager) ===<br />
<br />
This is a common issue in a number of window managers. (DWM, Awesome, bspwm) Java does not play well with these window managers. There are two methods.<br />
<br />
First try setting the environment variable by running<br />
<br />
$ export _JAVA_AWT_WM_NONREPARENTING=1<br />
<br />
If Matlab works afterwards, export the variable in your {{ic|.xinitrc}}.<br />
<br />
If it doesn't resolve, you have to fool Java into thinking the WM is named LG3D. (It's an old, depreciated WM that Java applications ironically support) Clean the previous environment variable, install the [http://tools.suckless.org/wmname wmname] utility, and run.<br />
<br />
wmname LG3D<br />
<br />
Try running Matlab. If it works, put the fix in your starting script. ({{ic|.xinitrc}}, {{ic|bspwmrc}} and similar should be OK) Do note that other applications (such as {{ic|neofetch}}, or {{ic|tdrop}}) will think your WM is named LG3D, so you will have to configure them accordingly. Another solution is to run the command only before launching Matlab, and fixing the name after you are done with Matlab.<br />
<br />
If it doesn't work, try the combination of both. (The second line works in bspwm) If it still doesn't work, try googling similar issues with java in general.<br />
<br />
=== Garbled or invisible text ===<br />
<br />
Set the environment variable <code>J2D_D3D</code> to <code>false</code>[https://stackoverflow.com/questions/22737535/swing-rendering-appears-broken-in-jdk-1-8-correct-in-jdk-1-7].<br />
<br />
In newer versions of MATLAB (R2015b) [https://www.reddit.com/r/archlinux/comments/3yaga8/matlab_installer_bonked/] this also requires setting <code>MATLAB_JAVA</code> to something openjdk based. Example:<br />
<br />
export J2D_D3D=false<br />
./bin/glnxa64/install_unix -javadir /usr/lib/jvm/java-7-openjdk/jre<br />
<br />
=== Corrupted text and fonts in menus and fields ===<br />
If you notice that the menus or the input fields are corrupted or not appearing correctly then you can try to activate the ''"'''Use antialiasing to smooth desktop fonts'''"'' option in Matlab preferences, it seems to solve the problem. Go to '''''Preferences -> Matlab -> Fonts''''' and activate it. You will need to restart Matlab in order to take affect.<br />
<br />
=== Installation ===<br />
As one installs Matlab, it might complain that it cannot find a package, for the most part just look at the package name and then install it with [[Pacman]], or in the case of x86_64 there are some libraries only in [[AUR]].<br />
<br />
=== Install-time library errors ===<br />
* Make sure that the symlink {{ic|bin/glnx64/libstdc++.so.6}} is pointing to the correct version of {{ic|libstdc++.so.xx}} (which is also in the same directory and has numbers where 'xx' is). By default, it may be pointing to an older (and nonexistent) version (different value for 'xx').<br />
<br />
* Make sure the device you're installing from is not mounted as {{ic|noexec}}<br />
<br />
* If you downloaded the files from Mathworks' website, make sure they are not on an NTFS or FAT partition, because that can mess up the symlinks. Ext4 or Ext3 should work.<br />
<br />
=== Resolving start warnings/errors ===<br />
<br />
* Even if all needed libraries are installed, Matlab when starting can still report some missing libraries. This is resolved by symbolic linking of needed libraries to directories that Matlab checks at start-up. For example, if Matlab triggers error/warning about missing {{ic|/lib64/libc.so.6}} library, this can be resolved by:<br />
<br />
# ln -s /lib/libc.so.6 /lib64<br />
<br />
* Matlab R2011b with an up-to-date Arch Linux (as of March 12, 2012) fails on startup with the familiar "Failure loading desktop class." A solution is to point Matlab to the system JVM (confirmed to work with the {{Pkg|jdk7-openjdk}} package):<br />
<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
* Matlab R2017b with an up-to-date Arch Linux (as of September 30, 2017) fails on startup with the familiar "Failure loading desktop class." A solution is to install outdated versions of the libraries in the packages {{Pkg|cairo}} (1.14.10 works) and {{Pkg|harfbuzz}} (1.4.6 works) to a local directory and add them to the LD_LIBRARY_PATH for matlab (See also: [https://bbs.archlinux.org/viewtopic.php?id=228944]): <br />
<br />
LD_LIBRARY_PATH="/opt/matlab/outdatedLibraries/:$LD_LIBRARY_PATH" /opt/matlab/R2017b/bin/matlab<br />
<br />
=== Segmentation fault on startup ===<br />
<br />
If Matlab stops working after upgrading {{Pkg|ncurses}} to v6.x, [[install]] the {{AUR|ncurses5-compat-libs}} package. See [https://bbs.archlinux.org/viewtopic.php?id=202575 BBS#202575].<br />
<br />
=== Hangs on rendering or exiting with Intel graphics ===<br />
<br />
Some users have reported issues with DRI3 enabled on Intel Graphics chips. A possible workaround is to disable DRI3 and run MATLAB with hardware rendering on DRI2; to do so, launch MATLAB with the environment variable LIBGL_DRI3_DISABLE set to 1:<br />
<br />
LIBGL_DRI3_DISABLE=1 /{MATLAB}/bin/matlab<br />
<br />
If the previous workaround does not work, the issue can be circumvented by selecting software rendering with the MATLAB command (beware, performance may be very poor when doing e.g. big or complex 3D plots):<br />
<br />
opengl('save','software')<br />
<br />
See [https://bugzilla.redhat.com/show_bug.cgi?id=1357571] and [https://bugs.freedesktop.org/show_bug.cgi?id=96671] for more.<br />
<br />
=== Addon manager not working ===<br />
Addon manager requires the {{AUR|libselinux}} package to work. (in Matlab 2016b)<br />
<br />
Since upgrade from pango-1.40.5 to pango-1.40.6, the MATLABWindow application (responsible for Add-On Manager, Simulation Data Inspector and perhaps something else) cannot be started. [https://bugs.archlinux.org/task/54257]<br />
A workaround is to point MATLAB shipping glib libraries to those glib libraries from your system. There are 5 of those libraries in {{ic|matlabroot/R2017a/cefclient/sys/os/glnxa64}}, namely, as of R2017a:<br />
<br />
libgio-2.0.so<br />
libglib-2.0.so<br />
libgmodule-2.0.so<br />
libgobject-2.0.so<br />
libgthread-2.0.so<br />
<br />
Make it so that these symlinks are pointing to your system glib libraries instead of versions located in {{ic|matlabroot/R2017a/cefclient/sys/os/glnxa64}}.<br />
<br />
Relinking of "libfreetype.so.6" is also necessary to open these interfaces. This is found in {{ic|matlabroot/R2017a/bin/glnxa64/}}.<br />
<br />
If the window opens but is blank, consider switching the html renderer to: " webutils.htmlrenderer('basic');" as described in [[#Help browser]].<br />
<br />
=== Live Script Errors ===<br />
If you get the error when attempting to load or create a LiveScript:<br />
{{ic|Viewing matlab live script files is not currently supported by this operating system configuration}}<br />
The steps in [[#Addon manager not working]] may resolve the issue.<br />
=== Using webcam/video device ===<br />
Make sure the correct support package addons are installed (webcam or OS Generic Video Interface for example). If running matlab as a user, make sure your user has write permissions to wherever the support packages are being downloaded and installed. <br />
<br />
At least Matlab 2016b doesn't recognize webcams or imaq adapters correctly without gstreamer0.10. The gstreamer0.10 can be found in the aur and installed as a work around.<br />
<br />
Since MATLAB R2017a, Image Acqusition Toolbox is using GStreamer library version 1.0. It previously used version 0.10.<br />
<br />
=== MATLAB hangs for several minutes when closing Help Browser ===<br />
Since upgrade of glibc from 2.24 to 2.25, MATLAB (at least R2017a) hangs when closing Help Browser. The issue is related to the particular version of jxbrowser-chromium shipped with MATLAB.<br />
This issue is still present with glibc 2.26 and MATLAB R2017b.<br />
<br />
To fix this issue, download the [https://www.teamdev.com/jxbrowser latest jxbrowser] and replace the following jars from MATLAB:<br />
<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-chromium.jar<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-linux64.jar<br />
<br />
MATLAB should automatically unpack those jars into {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} when first opening Help Browser.<br />
Remove {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} directory to make sure MATLAB uses the latest jxbrowser.<br />
<br />
Unfortunately, this workaround doesn't work in R2017b anymore. Going deeper into investigation of this issue, it is related to a crash of one of jxbrowser-chromium processes. The parent process of jxbrowser-chromium then sits there and waits for response from a process that is already dead. This causes MATLAB main window to freeze. You can easily unfreeze MATLAB by manually killing all leftover jxbrowser-chromium processes.<br />
<br />
I've come up with this simple script that uses inotify and waits for user to close Help browser in MATLAB. It triggers when user closes Help browser and sends kill signal to all leftover jxbrowser-chromium processes:<br />
<br />
#!/usr/bin/bash<br />
<br />
if [ -z "$1" ]; then<br />
REL=R2017b<br />
else<br />
REL=$1<br />
fi<br />
<br />
JXPATH="/path/to/MATLAB/$REL/sys/jxbrowser-chromium/glnxa64/chromium"<br />
CMD="inotifywait -m -e CLOSE $JXPATH/resources.pak"<br />
<br />
#Exit if the daemon is already active<br />
if ! pgrep -f "$CMD" > /dev/null; then<br />
#Wait for user to close Help Browser, then killall leftover jxbrowser processes<br />
$CMD |<br />
while read line<br />
do<br />
killall "$JXPATH/jxbrowser-chromium"<br />
done<br />
else<br />
exit<br />
fi<br />
<br />
I run this script as part of my MATLAB start script like that:<br />
~/bin/unfreeze_matlab.sh R2017b &<br />
<br />
To make sure that this background job is killed when I exit MATLAB, I use this in the beginning of MATLAB start script:<br />
trap "trap - SIGTERM && kill -- -$$" SIGINT SIGTERM EXIT<br />
<br />
=== Some dropdown menus cannot be selected ===<br />
In some interfaces - such as Simulation Data Inspector or Simulink Test Manager - nothing happens when choosing an item in dropdown menu (for example, when trying to change a number of subplots in Simulation Data Inspector). To work around this issue, hold down the Shift key while clicking the item in dropdown menu.<br />
<br />
=== Not starting - licensing error===<br />
In case MATLAB will not start from a [[desktop environment]] by the call of its [[desktop file]] one should see the output as you start it from the terminal.<br />
For a ''Licensing error'' such as:<br />
{{hc<br />
|# matlab|<br />
MATLAB is selecting SOFTWARE OPENGL rendering.<br />
License checkout failed.<br />
License Manager Error -9<br />
This error may occur when: <br />
-The hostid of this computer does not match the hostid in the license file. <br />
-A Designated Computer installation is in use by another user. <br />
If no other user is currently running MATLAB, you may need to activate.<br />
<br />
Troubleshoot this issue by visiting: <br />
http://www.mathworks.com/support/lme/R2017a/9<br />
<br />
Diagnostic Information:<br />
Feature: MATLAB <br />
License path: /home/<USER>/.matlab/R2017a_licenses/license_<NUM>_R2017a.lic:/home/<USER>/.matlab/R2017a_licenses/lice<br />
nse_Darkness_<NUM>_R2017a.lic:/opt/MATLAB/R2017a/licenses/license.dat:/opt/MATLAB/R2017a/licenses/*<br />
.lic <br />
Licensing error: -9,57.<br />
}}<br />
a re-[[#Activation|activation]] might solve the problem.</div>Bbaserdemhttps://wiki.archlinux.org/index.php?title=MATLAB&diff=492984MATLAB2017-10-12T12:14:13Z<p>Bbaserdem: I ellaborated the part about Blank/grey UI when using WM:</p>
<hr />
<div>[[Category:Mathematics and science]]<br />
[[ja:Matlab]]<br />
{{Related articles start}}<br />
{{Related|Octave}}<br />
{{Related|Sage-mathematics}}<br />
{{Related|Mathematica}}<br />
{{Related articles end}}<br />
{{Poor writing|unnecessarily verbose}}<br />
From the [http://www.mathworks.com/products/matlab/ official website]:<br />
<br />
:''MATLAB is a high-level language and interactive environment for numerical computation, visualization, and programming. Using MATLAB, you can analyze data, develop algorithms, and create models and applications. The language, tools, and built-in math functions enable you to explore multiple approaches and reach a solution faster than with spreadsheets or traditional programming languages, such as C/C++ or Java.''<br />
<br />
== Overview ==<br />
<br />
MATLAB is proprietary software produced by The MathWorks and requires a license to obtain, install, and activate. New versions of MATLAB are released twice a year,<br />
release names are composed of {{ic|R}}, the year of the release and {{ic|a}} or {{ic|b}}.<br />
Since R2012b MATLAB has only been available for 64-bit Linux. Arch Linux is not officially supported.<br />
[http://www.mathworks.co.uk/support/sysreq/current_release/index.html]<br />
<br />
== Installation ==<br />
<br />
A complete copy of the MATLAB software must be obtained before it can be installed. The MATLAB software is available to licenses holders on both a DVD and through the [http://www.mathworks.com The MathWorks website]. In addition to the software a file installation key is required for installation. It is possible to install MATLAB either with the {{aur|matlab}} package from the [[AUR]] or from the MATLAB installation software directly. The advantage of the {{aur|matlab}} package is that it manages dependencies and some of the nuances of the installation process while installing directly from the MATLAB installation software can be done by regular users to their home directories and works for any release of MATLAB (the {{aur|matlab}} package only works for releases including and after R2010b).<br />
<br />
=== Installing from the MATLAB installation software ===<br />
<br />
The MATLAB installation software is self contained and does not require any additional packages to install in silent mode. To install with the GUI a working [[Xorg]] graphical display is necessary. The installation is handled by the {{ic|install}} script. You can run the script as root to install MATLAB system-wide or your user to install it only for you.<br />
<br />
MATLAB 2016a and earlier is not compatible with {{Pkg|ncurses}} 6, so you must install the {{AUR|ncurses5-compat-libs}} package. See [[#Segmentation fault on startup]] for more info.<br />
<br />
During the installation, you are asked if you want symlinks to be created. If you did not choose to do so, you can now manually create a symlink in {{ic|/usr/local/bin}} to make it easier to launch in terminal:<br />
<br />
# ln -s /{MATLAB}/bin/matlab /usr/local/bin<br />
<br />
==== Desktop entry ====<br />
<br />
Optionally create a [[desktop entry]]. The MIME type of MATLAB files is {{ic|text/x-matlab}}.<br />
<br />
Start {{ic|matlab}} with:<br />
<br />
* {{ic|-desktop}} to run Matlab without a terminal.<br />
* {{ic|-nosplash}} to prevent the splash screen from showing up.<br />
<br />
In order for icons to appear correctly {{ic|StartupWMClass}} needs to be set in the desktop entry. To find it out start MATLAB, run {{ic|xprop {{!}} grep WM_CLASS}} and select the MATLAB window.<br />
<br />
=== Installing from the AUR package ===<br />
<br />
The EULA for the proprietary MATLAB software is restrictive. The {{aur|matlab}} package from the [[AUR]] is designed to allow MATLAB to be integrated into and managed by Arch. The package should be built on the system on which it is going to be installed and the package should be deleted from the installation location and the [[Pacman]] cache following installation. Distributing the package is a clear violation of the EULA.<br />
<br />
The {{aur|matlab}} package from the [[AUR]] defaults to building a package for the most recent 64-bit release of MATLAB, although the PKGBUILD supports MATLAB releases from R2010b and even the installation of multiple releases simultaneous. The PKGBUILD defaults to installing all toolboxes that the file identification key allows, however, the PKGBUILD can be edited to include only a subset of the toolboxes. The selection of the toolboxes must be finalized at the time of package creation due to DRM policies put in place by The MathWorks. The {{aur|matlab}} package from the [[AUR]] requires that both the MATLAB installation software and the file installation key are available in the source directory. The file installation key must be in a file called {{ic|matlab.fik}} and the installation software must be in an iso file called {{ic|matlab.iso}}. Once the iso file and file installation key are created, the MATLAB package can be created and install as usual.<br />
<br />
For MATLAB releases between r2010b and r2011a the contents of the iso file must include: {{ic|./archives/}}, {{ic|./bin/}}, {{ic|./etc/}}, {{ic|./help/}}, {{ic|./java/}}, {{ic|./activate.ini}}, {{ic|./install}}, and {{ic|./installer_input.txt}}. If the MATLAB download agent is used to download the installation software, then the iso file can be trivially created by simply running {{ic|mkisofs -r -o}} on the download directory.<br />
<br />
For MATLAB releases including and after r2011b the contents of the iso file must include: {{ic|./archives/}}, {{ic|./bin/}}, {{ic|./etc/}}, {{ic|./help/}}, {{ic|./java/}}, {{ic|./activate.ini}}, {{ic|./install}}, and {{ic|./installer_input.txt}}. For version before r2014a, the MATLAB download agent could download all the required files and the iso file could be trivially created by simply running {{ic|mkisofs -r -o}} on the download directory. For MATLAB releases including and after r2014a the MATLAB download agent only downloads the MATLAB installer. The MATLAB installer then needs to be run to downloaded the MATLAB software and toolboxes. Therefore, a two step process is required to generate this iso file with the MATLAB download agent. First, you download and run the MATLAB installer to install MATLAB in a temporary directory. This process downloads the MATLAB software and toolboxes by default to {{ic|~/Downloads/MathWorks}} (this can be changed by passing the flag {{ic|-downloadFolder /path/to/directory}}). It is actually possible quit the MATLAB installer once the software and toolboxes are downloaded. Once the software and toolboxes are downloaded the required iso file can be created by merging the installer directory (containing above mentioned files) and the download directory (containing {{ic|./archives/}}), and then running {{ic|mkisofs -r -o}} on the resulting directory.<br />
<br />
== Activation ==<br />
<br />
In order to run MATLAB it requires a license file to be installed. The license file can be generated with {{ic|$MATLABROOT/bin/activate_matlab.sh}} or downloaded from [http://www.mathworks.com MATLAB] directly. <br />
<br />
=== R2013b and earlier ===<br />
<br />
Up to and including R2013b the license file was linked to the MAC address of eth0. This causes problems with the [[Network_configuration#Device_names|Predictable Network Interface Names]] used by Arch Linux. It is possible to disable predictable network interface names by adding {{ic|1=net.ifnames=0}} in your kernel command line or by creating a udev rule file<br />
<br />
# ln -s /dev/null /etc/udev/rules.d/80-net-setup-link.rules<br />
<br />
It is also possible to [[Network_configuration#Change_device_name|change the name of a device]], but changing the name to eth0 can result in race conditions between the kernel and udev during boot. Another solution is to create a dummy network interface named eth0 with the MAC address linked to the license file. First, get that MAC address using {{ic|ip link}}. Next, create the following file:<br />
<br />
{{hc|/etc/systemd/system/matlab.licensing.service|<nowiki><br />
[Unit]<br />
Description=Dummy network interface for MATLAB<br />
Requires=systemd-modules-load.service<br />
<br />
[Service]<br />
Type=oneshot<br />
ExecStart=/sbin/ip link set dev dummy0 name eth0<br />
ExecStart=/sbin/ip link set dev eth0 address 00:00:00:00:00:00<br />
<br />
[Install]<br />
WantedBy=multi-user.target<br />
</nowiki>}}<br />
<br />
Replace 00:00:00:00:00:00 with the MAC address linked to the license file.<br />
<br />
Then make the script run on boot:<br />
<br />
# systemctl enable matlab.licensing<br />
<br />
Finally, set the dummy module to load on boot by creating the following file:<br />
<br />
{{hc|/etc/modules-load.d/dummy.conf|<nowiki>dummy</nowiki>}}<br />
<br />
== Configuration ==<br />
<br />
=== Java ===<br />
<br />
The MATLAB software is bundled with a JVM and therefore it is not necessary to install [[Java]]. The JVM version bundled with MATLAB typically lags behind {{pkg|jre7-openjdk}} from the [[official repositories]] and it is possible, although not required, to use the {{ic|MATLAB_JAVA}} environment variable to specify the path of an alternative JRE. For example, to specify the {{pkg|jre7-openjdk}} JRE and check the resulting version of Java, do:<br />
<br />
$ MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre matlab -nodesktop -nosplash -r "version -java, exit" | grep Java<br />
<br />
{{Accuracy|overly specific, yet no references to claimed behaviour}}<br />
<br />
Using alternative JRE would often solve some long-standing problems, such as the extra "{{ic|MEvent. CASE!}}" string when doing two-finger scrolling using touchpad. Another problem that can be solved in this way is the ugly, limited fonts provided by default, especially for some Chinese characters.<br />
<br />
=== OpenGL acceleration ===<br />
<br />
MATLAB can take advantage of hardware based 2D and 3D OpenGL acceleration. Support for hardware acceleration needs to be configured outside of MATLAB. Appropriate [[video drivers]] need to be installed along with the OpenGL utility library {{Pkg|glu}} package. If X11 forwarding is being used, the video drivers need to be installed on both the client and server. To check if MATLAB is making use of hardware based OpenGL acceleration run:<br />
<br />
$ matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If "software rendering" is not "false", then there is a problem with your hardware acceleration. If this is the case make sure OpenGL is configured correctly on the system. This can be done with the {{ic|glxinfo}} program from the {{Pkg|mesa-demos}} package:<br />
<br />
$ glxinfo | grep "direct rendering"<br />
<br />
If "direct rendering" is not "yes", then there is likely a problem with your system configuration.<br />
<br />
If glxinfo works but not matlab, you can try to run:<br />
$ export LD_PRELOAD=/usr/lib/libstdc++.so; export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/; matlab -nodesktop -nosplash -r "opengl info; exit" | grep Software<br />
<br />
If its works, you can edit Matlab launcher script to add:<br />
<br />
export LD_PRELOAD=/usr/lib/libstdc++.so<br />
export LD_LIBRARY_PATH=/usr/lib/xorg/modules/dri/<br />
<br />
=== Fonts for figures ===<br />
<br />
{{Note| This section only applies to R2014a and earlier as starting with R2014b MATLAB uses True Type Fonts. So as long as {{ic|fc-match Helvetica}} returns a font, figure fonts should work as expected.}}<br />
<br />
While MATLAB can be run in a text only mode, it also provides advanced graphics capabilities. To confirm that MATLAB is making use of the system fonts run:<br />
<br />
$ matlab -nodesktop -nosplash -r "xlabel('BIG FONT', 'FontSize', 42); ylabel('small font', 'FontSize', 12); pause; exit" > /dev/null<br />
<br />
This should produce a MATLAB figure with "BIG FONT" in a large font on the abscissa and "small font" in a small font on the ordinate. If "BIG FONT" and "small font" are both the same size, refer to [[Xorg#Program_requests_.22font_.27.28null.29.27.22|Xorg fonts]] to confirm that the correct the bitmap font package (either {{Pkg|xorg-fonts-100dpi}} or {{Pkg|xorg-fonts-75dpi}} from the [[official repositories]]) is installed on your system.<br />
<br />
=== Sound ===<br />
<br />
To confirm that MATLAB is able to use the default soundcard to present sounds run:<br />
<br />
$ matlab -nodesktop -nosplash -r "load handel; sound(y, Fs); pause(length(y)/Fs); exit" > /dev/null<br />
<br />
This should play an except from Handel's "Hallelujah Chorus." If this fails make sure [[ALSA]] is properly configured. This can be done with the {{ic|speaker-test}} program from the {{Pkg|alsa-utils}} package from the [[official repositories]]:<br />
<br />
$ speaker-test<br />
<br />
If you do not hear anything, then there is likely a problem with your system configuration.<br />
<br />
=== GPU computing ===<br />
<br />
MATLAB can take advantage of [http://www.mathworks.co.uk/discovery/matlab-gpu.html CUDA enabled GPUs] to speed up applications. In order to take advantage of a supported GPU install the {{Pkg|nvidia}}, {{Pkg|nvidia-utils}}, {{Pkg|ocl-icd}}, {{Pkg|opencl-nvidia}}, and {{Pkg|cuda}} packages from the [[official repositories]]. To check if MATLAB is able to utilize the GPU run:<br />
<br />
$ matlab -nodesktop -nosplash -r "x=rand(10, 'single'); g=gpuArray(x); Success=isequal(gather(g), x), exit" | sed -ne '/Success =/,$p'<br />
<br />
=== Install supported compilers ===<br />
<br />
In order to access the full functionality of MATLAB (e.g., to use Simulink, Builder JA, and MEX-file compilation), supported versions of the {{ic|gcc}}, {{ic|g++}}, {{ic|gfortran}}, and {{ic|jdk}} compilers must be installed. Details about the supported compilers for the [http://www.mathworks.com/support/compilers/current_release/index.html?sec=glnxa64 current release] and [http://www.mathworks.com/support/sysreq/previous_releases.html previous releases] are available online. Many of the supported {{ic|gcc}}, {{ic|g++}}, {{ic|jdk}} compiler versions for past MATLAB releases are available from the [[AUR]] (e.g., {{AUR|gcc43}}, {{AUR|gcc44}}, {{AUR|gcc47}}, {{AUR|gcc49}}and {{AUR|jdk6}}), while past versions of the {{ic|gfortran}} compilers are not packaged.<br />
<br />
To use previous versions of the the {{ic|gcc}}, {{ic|g++}}, and {{ic|gfortran}} compilers with MEX files, edit {{ic|${MATLAB}/bin/mexopts.sh}} and replace all occurrences of {{ic|<nowiki>CC='gcc'</nowiki>}} with {{ic|<nowiki>CC='gcc-4.X'</nowiki>}}, {{ic|<nowiki>CXX='g++'</nowiki>}} with {{ic|<nowiki>CXX='g++-4.X'</nowiki>}}, and {{ic|<nowiki>FC='gfortran'</nowiki>}} with {{ic|<nowiki>FC='gfortran-4.X'</nowiki>}}, where {{ic|X}} is the compiler version appropriate for the particular MATLAB release.<br />
<br />
{{Note|Though, it's no officially supported, one could still use higher version of compiler, and ignore the warnings.}}<br />
<br />
=== Help browser ===<br />
<br />
The help browser uses valuable slots in the dynamic thread vector and causes competition with core functionality provided by libraries like the BLAS that also depend on the dynamic thread vector. The help browser can be configured to use fewer slots in the dynamic thread vector with<br />
<br />
>> webutils.htmlrenderer('basic');<br />
<br />
This is a persistent change and to reverse it use<br />
<br />
>> webutils.htmlrenderer('default');<br />
<br />
=== Garbled Interface ===<br />
<br />
export J2D_D3D=false<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
== Troubleshooting ==<br />
<br />
=== Static TLS errors ===<br />
<br />
MATLAB has a number of libraries that have been compiled with static thread local storage (TLS) including the help broswer {{ic|doc}} and the BLAS libraries. For example,<br />
<br />
>> doc('help');<br />
>> ones(10)*randn(10);<br />
Error using * <br />
BLAS loading error:<br />
dlopen: cannot load any more object with static TLS<br />
<br />
is related to the bugs:<br />
<br />
* [http://www.mathworks.de/support/bugreports/961964 961964] for which patched libraries are available from [http://www.mathworks.de/support/bugreports/license/accept_license/5730?fname=attachment_961964_12b_13a_13b_14a_glnxa64_2014-01-30.zip&geck_id=961964 MathWorks]<br />
* [http://www.mathworks.com/support/bugreports/1003952 1003952] for which workarounds exist<br />
<br />
A more general solution of recompiling {{ic|glibc}} has also been suggested. [http://stackoverflow.com/a/19468365/2787723]<br />
<br />
=== MATLAB crashes when displaying graphics ===<br />
<br />
To identify this error, start MATLAB with<br />
<br />
LIBGL_DEBUG=verbose matlab<br />
<br />
from the terminal and try to collect OpenGL information with {{ic|opengl info}} from the MATLAB command prompt. If it crashes again and there is an output line like <br />
<br />
libGL error: dlopen /usr/lib/xorg/modules/dri/swrast_dri.so failed <br />
(/usr/local/MATLAB/R2011b/bin/glnxa64/../../sys/os/glnxa64/libstdc++.so.6: <br />
version `GLIBCXX_3.4.15' not found (required by /usr/lib/xorg/modules/dri/swrast_dri.so))<br />
<br />
then the problem is that MATLAB uses its own GNU C++ library, which is an older version than the up-to-date version on your Archlinux system. Make MATLAB use the current C++ library for your system by<br />
<br />
cd /usr/local/MATLAB/R(your release)/sys/os/glnxa64<br />
sudo unlink libstdc++.so.6<br />
sudo ln -s /usr/lib/libstdc++.so.6<br />
<br />
If MATLAB still crashes or corrupts graphics (during startup or when plotting), make sure Java's 2D OpenGL rendering is disabled.<br />
The environment variable {{ic|_JAVA_OPTIONS}} should not contain {{ic|1=-Dsun.java2d.opengl=true}}.<br />
<br />
=== Blank/grey UI when using WM (non-reparenting window manager) ===<br />
<br />
This is a common issue in a number of window managers. (DWM, Awesome, bspwm) Java does not play well with these window managers. There are two methods.<br />
<br />
First try setting the environment variable by running<br />
<br />
$ export _JAVA_AWT_WM_NONREPARENTING=1<br />
<br />
If Matlab works afterwards, export the variable in your {{ic|.xinitrc}}.<br />
<br />
If it doesn't resolve, you have to fool Java into thinking the WM is named LG3D. (It's an old WM that Java applications used to support) Install the [http://tools.suckless.org/wmname wmname] utility, and run.<br />
<br />
wmname LG3D<br />
<br />
Try running Matlab. If it works, put the fix in your starting script. ({{ic|.xinitrc}}, {{ic|bspwmrc}} and similar should be OK)<br />
<br />
=== Garbled or invisible text ===<br />
<br />
Set the environment variable <code>J2D_D3D</code> to <code>false</code>[https://stackoverflow.com/questions/22737535/swing-rendering-appears-broken-in-jdk-1-8-correct-in-jdk-1-7].<br />
<br />
In newer versions of MATLAB (R2015b) [https://www.reddit.com/r/archlinux/comments/3yaga8/matlab_installer_bonked/] this also requires setting <code>MATLAB_JAVA</code> to something openjdk based. Example:<br />
<br />
export J2D_D3D=false<br />
./bin/glnxa64/install_unix -javadir /usr/lib/jvm/java-7-openjdk/jre<br />
<br />
=== Corrupted text and fonts in menus and fields ===<br />
If you notice that the menus or the input fields are corrupted or not appearing correctly then you can try to activate the ''"'''Use antialiasing to smooth desktop fonts'''"'' option in Matlab preferences, it seems to solve the problem. Go to '''''Preferences -> Matlab -> Fonts''''' and activate it. You will need to restart Matlab in order to take affect.<br />
<br />
=== Installation ===<br />
As one installs Matlab, it might complain that it cannot find a package, for the most part just look at the package name and then install it with [[Pacman]], or in the case of x86_64 there are some libraries only in [[AUR]].<br />
<br />
=== Install-time library errors ===<br />
* Make sure that the symlink {{ic|bin/glnx64/libstdc++.so.6}} is pointing to the correct version of {{ic|libstdc++.so.xx}} (which is also in the same directory and has numbers where 'xx' is). By default, it may be pointing to an older (and nonexistent) version (different value for 'xx').<br />
<br />
* Make sure the device you're installing from is not mounted as {{ic|noexec}}<br />
<br />
* If you downloaded the files from Mathworks' website, make sure they are not on an NTFS or FAT partition, because that can mess up the symlinks. Ext4 or Ext3 should work.<br />
<br />
=== Resolving start warnings/errors ===<br />
<br />
* Even if all needed libraries are installed, Matlab when starting can still report some missing libraries. This is resolved by symbolic linking of needed libraries to directories that Matlab checks at start-up. For example, if Matlab triggers error/warning about missing {{ic|/lib64/libc.so.6}} library, this can be resolved by:<br />
<br />
# ln -s /lib/libc.so.6 /lib64<br />
<br />
* Matlab R2011b with an up-to-date Arch Linux (as of March 12, 2012) fails on startup with the familiar "Failure loading desktop class." A solution is to point Matlab to the system JVM (confirmed to work with the {{Pkg|jdk7-openjdk}} package):<br />
<br />
export MATLAB_JAVA=/usr/lib/jvm/java-7-openjdk/jre<br />
<br />
* Matlab R2017b with an up-to-date Arch Linux (as of September 30, 2017) fails on startup with the familiar "Failure loading desktop class." A solution is to install outdated versions of the libraries in the packages {{Pkg|cairo}} (1.14.10 works) and {{Pkg|harfbuzz}} (1.4.6 works) to a local directory and add them to the LD_LIBRARY_PATH for matlab (See also: [https://bbs.archlinux.org/viewtopic.php?id=228944]): <br />
<br />
LD_LIBRARY_PATH="/opt/matlab/outdatedLibraries/:$LD_LIBRARY_PATH" /opt/matlab/R2017b/bin/matlab<br />
<br />
=== Segmentation fault on startup ===<br />
<br />
If Matlab stops working after upgrading {{Pkg|ncurses}} to v6.x, [[install]] the {{AUR|ncurses5-compat-libs}} package. See [https://bbs.archlinux.org/viewtopic.php?id=202575 BBS#202575].<br />
<br />
=== Hangs on rendering or exiting with Intel graphics ===<br />
<br />
Some users have reported issues with DRI3 enabled on Intel Graphics chips. A possible workaround is to disable DRI3 and run MATLAB with hardware rendering on DRI2; to do so, launch MATLAB with the environment variable LIBGL_DRI3_DISABLE set to 1:<br />
<br />
LIBGL_DRI3_DISABLE=1 /{MATLAB}/bin/matlab<br />
<br />
If the previous workaround does not work, the issue can be circumvented by selecting software rendering with the MATLAB command (beware, performance may be very poor when doing e.g. big or complex 3D plots):<br />
<br />
opengl('save','software')<br />
<br />
See [https://bugzilla.redhat.com/show_bug.cgi?id=1357571] and [https://bugs.freedesktop.org/show_bug.cgi?id=96671] for more.<br />
<br />
=== Addon manager not working ===<br />
Addon manager requires the {{AUR|libselinux}} package to work. (in Matlab 2016b)<br />
<br />
Since upgrade from pango-1.40.5 to pango-1.40.6, the MATLABWindow application (responsible for Add-On Manager, Simulation Data Inspector and perhaps something else) cannot be started. [https://bugs.archlinux.org/task/54257]<br />
A workaround is to point MATLAB shipping glib libraries to those glib libraries from your system. There are 5 of those libraries in {{ic|matlabroot/R2017a/cefclient/sys/os/glnxa64}}, namely, as of R2017a:<br />
<br />
libgio-2.0.so<br />
libglib-2.0.so<br />
libgmodule-2.0.so<br />
libgobject-2.0.so<br />
libgthread-2.0.so<br />
<br />
Make it so that these symlinks are pointing to your system glib libraries instead of versions located in {{ic|matlabroot/R2017a/cefclient/sys/os/glnxa64}}.<br />
<br />
Relinking of "libfreetype.so.6" is also necessary to open these interfaces. This is found in {{ic|matlabroot/R2017a/bin/glnxa64/}}.<br />
<br />
If the window opens but is blank, consider switching the html renderer to: " webutils.htmlrenderer('basic');" as described in [[#Help browser]].<br />
<br />
=== Live Script Errors ===<br />
If you get the error when attempting to load or create a LiveScript:<br />
{{ic|Viewing matlab live script files is not currently supported by this operating system configuration}}<br />
The steps in [[#Addon manager not working]] may resolve the issue.<br />
=== Using webcam/video device ===<br />
Make sure the correct support package addons are installed (webcam or OS Generic Video Interface for example). If running matlab as a user, make sure your user has write permissions to wherever the support packages are being downloaded and installed. <br />
<br />
At least Matlab 2016b doesn't recognize webcams or imaq adapters correctly without gstreamer0.10. The gstreamer0.10 can be found in the aur and installed as a work around.<br />
<br />
Since MATLAB R2017a, Image Acqusition Toolbox is using GStreamer library version 1.0. It previously used version 0.10.<br />
<br />
=== MATLAB hangs for several minutes when closing Help Browser ===<br />
Since upgrade of glibc from 2.24 to 2.25, MATLAB (at least R2017a) hangs when closing Help Browser. The issue is related to the particular version of jxbrowser-chromium shipped with MATLAB.<br />
This issue is still present with glibc 2.26 and MATLAB R2017b.<br />
<br />
To fix this issue, download the [https://www.teamdev.com/jxbrowser latest jxbrowser] and replace the following jars from MATLAB:<br />
<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-chromium.jar<br />
matlabroot/java/jarext/jxbrowser-chromium/jxbrowser-linux64.jar<br />
<br />
MATLAB should automatically unpack those jars into {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} when first opening Help Browser.<br />
Remove {{ic|matlabroot/sys/jxbrowser-chromium/glnxa64/chromium}} directory to make sure MATLAB uses the latest jxbrowser.<br />
<br />
Unfortunately, this workaround doesn't work in R2017b anymore. Going deeper into investigation of this issue, it is related to a crash of one of jxbrowser-chromium processes. The parent process of jxbrowser-chromium then sits there and waits for response from a process that is already dead. This causes MATLAB main window to freeze. You can easily unfreeze MATLAB by manually killing all leftover jxbrowser-chromium processes.<br />
<br />
I've come up with this simple script that uses inotify and waits for user to close Help browser in MATLAB. It triggers when user closes Help browser and sends kill signal to all leftover jxbrowser-chromium processes:<br />
<br />
#!/usr/bin/bash<br />
<br />
if [ -z "$1" ]; then<br />
REL=R2017b<br />
else<br />
REL=$1<br />
fi<br />
<br />
JXPATH="/path/to/MATLAB/$REL/sys/jxbrowser-chromium/glnxa64/chromium"<br />
CMD="inotifywait -m -e CLOSE $JXPATH/resources.pak"<br />
<br />
#Exit if the daemon is already active<br />
if ! pgrep -f "$CMD" > /dev/null; then<br />
#Wait for user to close Help Browser, then killall leftover jxbrowser processes<br />
$CMD |<br />
while read line<br />
do<br />
killall "$JXPATH/jxbrowser-chromium"<br />
done<br />
else<br />
exit<br />
fi<br />
<br />
I run this script as part of my MATLAB start script like that:<br />
~/bin/unfreeze_matlab.sh R2017b &<br />
<br />
To make sure that this background job is killed when I exit MATLAB, I use this in the beginning of MATLAB start script:<br />
trap "trap - SIGTERM && kill -- -$$" SIGINT SIGTERM EXIT<br />
<br />
=== Some dropdown menus cannot be selected ===<br />
In some interfaces - such as Simulation Data Inspector or Simulink Test Manager - nothing happens when choosing an item in dropdown menu (for example, when trying to change a number of subplots in Simulation Data Inspector). To work around this issue, hold down the Shift key while clicking the item in dropdown menu.<br />
<br />
=== Not starting - licensing error===<br />
In case MATLAB will not start from a [[desktop environment]] by the call of its [[desktop file]] one should see the output as you start it from the terminal.<br />
For a ''Licensing error'' such as:<br />
{{hc<br />
|# matlab|<br />
MATLAB is selecting SOFTWARE OPENGL rendering.<br />
License checkout failed.<br />
License Manager Error -9<br />
This error may occur when: <br />
-The hostid of this computer does not match the hostid in the license file. <br />
-A Designated Computer installation is in use by another user. <br />
If no other user is currently running MATLAB, you may need to activate.<br />
<br />
Troubleshoot this issue by visiting: <br />
http://www.mathworks.com/support/lme/R2017a/9<br />
<br />
Diagnostic Information:<br />
Feature: MATLAB <br />
License path: /home/<USER>/.matlab/R2017a_licenses/license_<NUM>_R2017a.lic:/home/<USER>/.matlab/R2017a_licenses/lice<br />
nse_Darkness_<NUM>_R2017a.lic:/opt/MATLAB/R2017a/licenses/license.dat:/opt/MATLAB/R2017a/licenses/*<br />
.lic <br />
Licensing error: -9,57.<br />
}}<br />
a re-[[#Activation|activation]] might solve the problem.</div>Bbaserdem