Apr 182012

UPDATED 1-7-2013

I dug around for a long while trying to find a solution to this issue. I was able to find parts of it on various sites, but never found an explicit how to guide for setting this up. I’m sure most Linux pros know how to do this, but I am not that good and hopefully this will help other people use Linux for Citrix access.

Here is the environment I tested it on. I am running Kubuntu 11.10 12.04 LTS(note at bottom) , Citrix Receiver 12.1 beta for Linux. I am using a 24in NEC and 19in NEC monitor. I launch my VDI session from a web link ICA file.

If you need help setting up Citrix the instructions are located in the Citrix Ubuntu Documentation. I installed the reciever, USB support plugin, libmotif, and all that good stuff. You can find if you are missing any libraries by running the HDX script in the citric folder. for me that was “/opt/Citrix/ICAClient/util/hdxcheck.sh”, run the script as root to make sure it detects everything alright.

Now, Citrix is set up and should work fine normally, but getting it to span was giving me trouble. I saw on the Citrix and Ubuntu forums that adding the command line parameter “-span 1,2” would make it span properly. So, I just needed to get this to launch from a browser. I went into the folder Citrix was installed in again (/opt/Citrix/ICAClient) and edited the “wfica.sh” script located there. Basically this is a script that lanches the wfica program that launches Citrix. the last line of it is the command that launches the wfica program with the .ica file from the browser.

It should look like this:

$ICAROOT/wfica -file $1


I changed it to:

$ICAROOT/wfica -span 1,2 -file $1


Now it has the span parameter and will launch the file. Now I went into Firefox selected Edit -> Preferences, then to the Applications tab. Find “Citrix ICA settings file” in the list and change the program to launch it with to “wfica.sh”.

That should make Citrix launch with all the parameters we specified. You should be able to add any other command line parameters to this file if needed.


Something I like and wanted to fix(there is lots of documentation out there) is the middle click in VDI. By default it passes through a CTL+V and I wanted a standard middle click. You can do this by editing your ~/.ICAClient/wfclient.ini file and changing the MouseSendsControlV=True to False. Here is a link to the forum post I used.


NOTE: I upgraded to Kubuntu 12.10 and could not get it to work. The Citrix window would flash up quickly and then disappear and I ended up reinstalling 12.04 LTS. If I get a different result I will change the info here.

Another Note: I have Lubuntu 12.10 installed on a laptop I use and the Citrix Reciever works fine on that. I have not tested anything with dual monitors, but it looks like the Citrix stuff is working. I will try a fresh Kubuntu 12.10 install on my desktop and see if I can get Citrix working on that.


  9 Responses to “Making Citrix span across multiple monitors in Linux”

  1. I have the same problem: As I updated to Kubuntu 12.10 (or Linux Mint 14 KDE) it doesn’t start a window anymore.
    I hope you can find a solution.

  2. Hi, thank you so much! Followed the direction above and it worked for me Except one slight problem. The citrix session for some reason doesn’t span the entire monitor screen such as in a single monitor mode. I can stil see the Ubuntu top frame and left Dash menu bar. I suspect b/c of that, my citrix session is mal-aligned, so I don’t see the Windows taskbar or systray within the citrix session (as if it got scrolled off the screen to the bottom). Anyone know the fix, please share. thanks.

    • Sounds like Unity is being a bugger… I use mostly Kubuntu and Lubuntu for work (I only use standard Ubuntu for personal computing). I know I have had other apps get messed up by the Unity side bar. The solution for this somewhat out of my realm… If you do come across a solution I would appreciate if you share it and I will add it as a note to the post. Glad some of the information was helpful in any case.

      Also, I plan on testing 13.04 soon. I will update my Lubuntu to that first and make sure Citrix receiver works first. I will post results when I get the data.

      • I found the solution! Now I can finally switch over to Ubuntu instead of relying on my PC launch a dual screen Citrix. This and duplex printing (so I don’t waste paper) were my only two main hurdle.

        Anyway, it wasn’t a buggy Unity, but like my stupidity. The fix is simple. Go to System Setting, Display and disable the launch on the right monitor. By default each monitor has it only launcher in dual monitor setting, so kinda makes your mouse sticks to the launcher as you slide between two monitors. That apparently caused Citrix Receiver not expanding properly two both monitors. Should’ve discovered this sooner, but was stuck using my PC and didn’t get a chance to solve this. Anyway it is working now. Yay! Thanks.

        Now the only issue I have is how to temporarily exit the Citrix session w/o disconnecting. Or toggle between my “home” Ubuntu and Citrix session. The PC Citrix receiver has the pull down menu at the center of the monitor where you can click on home or ctrl-alt-del amongst other options, while the Citrix version doesn’t have that. Not a show stopper, just a minor inconvenience.

        • JokeDog,

          I ran into this issue in 13.04 and all I had to do was turn of “sticky edges.” Worked like a charm!

          As for your question about switching back and forth between the Citrix Session and the “home” desktop: I enabled workspaces. When in the citrix session, press Ctrl+F2. This will then pass key commands to the home desktop. Then I use CTRL+ALT+Arrowkey to switch to another workspace.

  3. Awesome! Cheers for that. Don’t have to buy windows now. All going on Ubuntu 14.04

    To edit the wfica.sh file
    sudo gedit wfica.sh

    save file before exiting.

    Select other on drop down list when adjusting the application settings on firefox

  4. Brilliant, finally found this after finding so many tips to display on multiple monitors. Works like a charm (Linux Mint 17) 🙂

  5. Might be because it’s probably quite outdated at this point (there isn’t really much to find on the subject), but this isn’t working for me on Lubuntu 18.04 with IcaClient Have 3 screens, Citrix opens on a single one only no matter what I seem to enter as the span. 🙁

    • Later, I found this article which has been pretty helpful: https://support.citrix.com/article/CTX209485

      In this case, it was an issue between Openbox and the _NET_WM_FULLSCREEN_MONITORS feature – switched to XFCE, and there it works out of the box. Still having problems defining the span manually in the way described there (it’s always trying to span all, I just want Citrix on two of them) – always getting “Cannot find an ICA file or appserv.ini entry”. It’s pretty odd and kind of annoying, but oh well…

 Leave a Reply

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>