Tip: Adding arbitrary apps to DispVM Applications menu

188 views
Skip to first unread message

Grzesiek Chodzicki

unread,
Mar 11, 2017, 12:31:08 PM3/11/17
to qubes-users
How to add custom applications to DispVM appmenu:

1. Install the required app in the TemplateVM upon which your DispVM depends (fedora-23/24 by default)
2. Shutdown the TemplateVM
3. In Dom0 run qvm-create-default-dvm <templatename>
4. At this point your app can be launched in DispVM, to confirm launch Xterm in DispVM and start your app from there. Now we are going to add an entry for it in the Applications menu
5. Go to /usr/local/share/applications
6. Create a new .desktop file for your app using following (example) syntax:

[Desktop Entry]
Version=1.0
Type=Application
Exec=sh -c 'echo <yourapphere> | /usr/lib/qubes/qfile-daemon-dvm qubes.VMShell dom0 DEFAULT red'
Icon=dispvm-red
Terminal=false
Name=DispVM: <put your desired name here>
GenericName=DispVM: <put your desired generic name here>
StartupNotify=false
Categories=Network;X-Qubes-VM;

7. go to /etc/xdg/menus/applications-merged
8. Edit the qubes-dispvm.menu using any editor
9. Under <Include> add another line containing the name of your .desktop file (so it looks like this):

<Include>
<Filename>qubes-dispvm-firefox.desktop</Filename>
<Filename>qubes-dispvm-xterm.desktop</Filename>
<Filename>yourdesktopfilehere</Filename>
</Include>

10. Your custom menu entry should appear on the Applications list now

Andrew - Frankly, this should be available within the GUI, should I add that to Documentation and/or create a ticket?

Andrew David Wong

unread,
Mar 11, 2017, 4:34:34 PM3/11/17
to Grzesiek Chodzicki, qubes-users
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Please feel free to do so.

- --
Andrew David Wong (Axon)
Community Manager, Qubes OS
https://www.qubes-os.org
-----BEGIN PGP SIGNATURE-----

iQIcBAEBCgAGBQJYxG1XAAoJENtN07w5UDAwXPQP/2hvs1va6LTLVTKWqQwlCmZd
BHjO59rE/0ENlsK+diT1ANpggPODWTTckw6+o/rsKhGvQXv/1PZfPJCzY3FV9w66
CndadAoQZunyGp1otJolGJHiS5ppqNXqm8+pzCNtkZ1YkYUj4QwjAAjZ67VU1y8H
C6yb774opL+CYiOzMOy3jTnnc/yWeJfFxGKNoB8YLRBqXrk8wG+vMVZYphoYo9xg
XIUu4xGZtCAdVvkcWT/RgBsHsdKoJ+CSij2B3bAx9vZPmmnndpB5HiXdzSZXLGhi
Dh/Xnc9+veqLKZ9rk1DpJ0CxLnaqAz3VEqzjha7cYL+yulZvH15LO46nIfyrFOQl
eUXK65hPj/C/+qFs2c1yBU0wFB3YcMe6fxdyUId5pKSQBU34hlDLDKhWsLVKNJ1t
gAxEtszRecgyi4px4sI0POHhsxbDauGpSBYYcNedFIKPNnERW+mNNA2d7n7xlwHj
2cNt7MzUFXIxq8UwS1A5pds9KMdA5cZXGIDujMGnuKvCDCtXyOcYQyJqbupJ6/c5
gS8JZ16RHi/oBMzmfenz2GVUjf3afATDN/oxAVJSoYtX/xZeoHQi3x2qePyfJ7hs
q+9PxBX5RbwQs27B0M+fwF1/1Myi1J9DC2mzBfc6lgb29WwKJxdIb/RXkoaUmFA2
7uzEP5ORYkQQgpwlIu7i
=0o7g
-----END PGP SIGNATURE-----

Grzesiek Chodzicki

unread,
Mar 11, 2017, 5:32:14 PM3/11/17
to qubes-users, grzegorz....@gmail.com

Unman

unread,
Mar 11, 2017, 6:15:25 PM3/11/17
to Andrew David Wong, Grzesiek Chodzicki, qubes-users
It would be useful to extend it to kde users, since that is also
currently supported.

I'm not sure that this should be added to the GUI: for those who use
multiple DVMTemplates now, (and that's coming in 4), you will have to
customise the menu on a per DVMTemplate basis. I think there's a good
deal to be considered first.

Is this to be a tip for the docs? I think there's a danger that they are
becoming difficult to navigate as is, despite Andrew's efforts.
I meant to chip in on the other thread, but I would prefer to see them
remain in the lists - the format of this one is excellent.

Of course, one has to weigh up where puzzled users will look - do you
think they search the documentation, look through the lists (we could
link to search results with "Tip:....", search the lists or just ask
straight off.
I don't have any feeling as to which is most likely to be found. Andrew?

unman


Ted Brenner

unread,
Mar 11, 2017, 11:07:01 PM3/11/17
to Unman, Andrew David Wong, Grzesiek Chodzicki, qubes-users
When searching Google or Duck Duck Go, the docs come up on top. So I think putting things in the docs is a good idea. The list is nice as a fall back but then you have to sift through a whole chain and piece together the answer. Much better to have the final "this is how you do X" in the docs.



--
You received this message because you are subscribed to the Google Groups "qubes-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to qubes-users+unsubscribe@googlegroups.com.
To post to this group, send email to qubes...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/qubes-users/20170311231524.GB25808%40thirdeyesecurity.org.
For more options, visit https://groups.google.com/d/optout.



--
Sent from my Desktop

Grzesiek Chodzicki

unread,
Mar 12, 2017, 6:12:53 AM3/12/17
to qubes-users
Unfortunately, I don't know how to do that in KDE, the last time I used it was around Qubes 3.0 release.

If somebody uses multipleDVM templates the easiest solution would be to add multiple entries in the Application Menu.

Personally I believe we should have a GUI for that for the same reason we should have a GUI for qvm-prefs, guid.conf and several other configuration mechanisms: so that Qubes is easier to use for non-technical users. Personally, I don't mind editing this stuff from command line, but I know a lot of people who would be turned off by that.

I planned to add this to the "DispVM Customization" article as I assume this is the first place a user would look.

Andrew David Wong

unread,
Mar 12, 2017, 8:14:06 AM3/12/17
to Unman, Grzesiek Chodzicki, qubes-users
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

On 2017-03-11 15:15, Unman wrote:
> On Sat, Mar 11, 2017 at 01:34:19PM -0800, Andrew David Wong wrote:
>>
>> On 2017-03-11 09:31, Grzesiek Chodzicki wrote:
>>> How to add custom applications to DispVM appmenu:
>>>
>>> [...]
>>>
>>> Andrew - Frankly, this should be available within the GUI,
>>> should I add that to Documentation and/or create a ticket?
>>>
>>
>> Please feel free to do so.
>>
>
> It would be useful to extend it to kde users, since that is also
> currently supported.
>
> I'm not sure that this should be added to the GUI: for those who
> use multiple DVMTemplates now, (and that's coming in 4), you will
> have to customise the menu on a per DVMTemplate basis. I think
> there's a good deal to be considered first.
>

Agreed.

> Is this to be a tip for the docs? I think there's a danger that
> they are becoming difficult to navigate as is, despite Andrew's
> efforts. I meant to chip in on the other thread, but I would
> prefer to see them remain in the lists - the format of this one is
> excellent.
>
> Of course, one has to weigh up where puzzled users will look - do
> you think they search the documentation, look through the lists
> (we could link to search results with "Tip:....", search the lists
> or just ask straight off. I don't have any feeling as to which is
> most likely to be found. Andrew?
>

I think a reasonable compromise is having a single page dedicated to
such tips in the docs:

https://www.qubes-os.org/doc/tips-and-tricks/

- --
Andrew David Wong (Axon)
Community Manager, Qubes OS
https://www.qubes-os.org
-----BEGIN PGP SIGNATURE-----

iQIcBAEBCgAGBQJYxTt5AAoJENtN07w5UDAw4HMQAL3OUpkSFRSYRubpPD5m41N7
pBwnX2ANKe3rj6AdHZhihVPxEYEPLueEalKgUflAjmvX5kJdWT5kOgZCslbrNPe1
g0D0HgyAqQgk2UtnHwDKBBgJTZ/GSEOUnYOLAxNRMDzISQSt+c7wGSX6cqmt70/e
Tuk3UPGj8/bW0U220obogVnmpL/nIfsdBwTlONhQJC24qnyy85RNnvY7AF2NS+Fb
LqufAi+rqOz9IibbYkfJRmcUW5G2IgdSjauqPlTnJQktkjh2T9Y4l2a7/5/+cI1x
8O+/1fITVQHX88X8kgQY6dW9OqlJqFy8iHjoIAWY3Sz8Ktio+sNeyFSm9fwm9B/R
iRIcB2sgcOq7MkftF64s2Yre/3TfOGNnYoWmr6IYZddtfYlugGWjCe1OXxxG0+wu
w6IBrjbdhj1XCa1+2TnijtAXJIH0kRT8w+zEIES30VIWU+HputsLBE5QBZzOsXmq
yW650fc1u7GJ9fC63HC2skP5zbR/Fd1EJ8AayFgwaSU8qQnjsYxrXwCWAdSO82qQ
qpb7JexqAnMzvTVKqnAAD/3QGXJ0BMVng4XSAsb/Os+eQNQrY/SbRjZn0qIhRc3i
wqaaY82peCgMgfopgZL55SegLnebxXmxJ3I2fHe/TbR5rpM+6yqyj8oBcCX2dFO8
tIeea+sVdKaZ+CXyBDs9
=U0Ni
-----END PGP SIGNATURE-----

Reply all
Reply to author
Forward
0 new messages