man-pages/man1/exo-open.1.html
2021-03-31 01:06:50 +01:00

169 lines
4.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of EXO-OPEN</TITLE>
</HEAD><BODY>
<H1>EXO-OPEN</H1>
Section: Xfce Users Manual (1)<BR>Updated: 11/03/2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
exo-open - Open URLs and launch preferred applications
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<DL COMPACT>
<DT id="1">
<B>exo-open</B> [[url]...]
<DT id="2">
<B>exo-open</B> --launch [category] [[parameter]...]
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
<B>exo-open</B>
<DD>is a command line frontend to the
<B>Xfce Preferred Applications</B>
framework. It can either be used to open a list of
<I>url</I>s with the default URL handler or launch the preferred application for a certain category.
<A NAME="lbAE">&nbsp;</A>
<H2>INVOCATION</H2>
<P>
<B>exo-open</B>
either takes a list of URLs and tries to open each of them using the default handler, or, when using the
<B>--launch</B>
tries to launch the preferred application for a certain category, optionally passing any number of
<I>parameter</I>s to the application.
<A NAME="lbAF">&nbsp;</A>
<H3>Options</H3>
<P>
<B>-?</B>, <B>--help</B>
<DL COMPACT><DT id="3"><DD>
Print brief help and exit.
</DL>
<P>
<B>-v</B>, <B>--version</B>
<DL COMPACT><DT id="4"><DD>
Print version information and exit.
</DL>
<P>
<B>--working-directory</B> <I>directory</I>
<DL COMPACT><DT id="5"><DD>
When using the
<B>--launch</B>
option and this option is specified as well, the application will be run in the given
<I>directory</I>. This is primarily useful when running the preferred
<B>TerminalEmulator</B>
from another application and you want the command in the terminal window to be run in a specific directory.
</DL>
<P>
<B>--launch</B> <I>category</I> <I>parameters...</I>
<DL COMPACT><DT id="6"><DD>
Launch the preferred application for the given
<I>category</I>
with the optional
<I>parameters...</I>, where
<I>category</I>
is either
<B>WebBrowser</B>,
<B>MailReader</B>,
<B>TerminalEmulator</B>
or
<B>FileManager</B>.
</DL>
<P>
If you do not specify the
<B>--launch</B>
option,
<B>exo-open</B>
will open all specified URLs with their preferred URL handlers. Else, if you specify the
<B>--launch</B>
option, you can select which preferred application you want to run, and pass additional
<I>parameters</I>
to the application (i.e. for
<B>TerminalEmulator</B>
you can pass the command line that should be run in the terminal).
<A NAME="lbAG">&nbsp;</A>
<H2>COMPOSING EMAILS</H2>
<P>
<B>exo-open</B>
allows users and developers to open the preferred email composer from the command line by simply invoking
<B>exo-open mailto:<A HREF="mailto:USER@HOST.TLD">USER@HOST.TLD</A></B>. This will open the composer window with
<I><A HREF="mailto:USER@HOST.TLD">USER@HOST.TLD</A></I>
as the recipient. This syntax is supported by all
<B>MailReader</B>s. In addition the
<B>MailReader</B>s that ship as part of libexo also support extended mailto:-URIs (but be aware that user-defined mailers do not necessarily support this), which allows you to also specify default values for the subject and the body of the mail, add additional recipients (both Cc: and To:) and attach files to emails. For example
<I>mailto:<A HREF="mailto:foo@foo.org">foo@foo.org</A>?cc=<A HREF="mailto:bar@bar.org">bar@bar.org</A>&amp;subject=Foo&amp;attach=/foo/bar.txt</I>
tells the composer to start an email to <A HREF="mailto:foo@foo.org">foo@foo.org</A> and <A HREF="mailto:bar@bar.org">bar@bar.org</A> with Foo in the subject and the file /foo/bar.txt attached to the message.
<A NAME="lbAH">&nbsp;</A>
<H2>AUTHOR</H2>
<P>
<B>exo-open</B>
was written by Benedikt Meurer
&lt;<A HREF="mailto:benny@xfce.org">benny@xfce.org</A>&gt;.
<P>
This manual page was provided by Benedikt Meurer
&lt;<A HREF="mailto:benny@xfce.org">benny@xfce.org</A>&gt;.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="10"><A HREF="#lbAE">INVOCATION</A><DD>
<DL>
<DT id="11"><A HREF="#lbAF">Options</A><DD>
</DL>
<DT id="12"><A HREF="#lbAG">COMPOSING EMAILS</A><DD>
<DT id="13"><A HREF="#lbAH">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:12 GMT, March 31, 2021
</BODY>
</HTML>