Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/Remmina/Remmina.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAntenore Gatta <antenore@simbiosi.org>2015-12-17 16:57:27 +0300
committerAntenore Gatta <antenore@simbiosi.org>2015-12-17 16:57:27 +0300
commit502c699d7fe26af605ae42fa8119f7018d1b2971 (patch)
treec9e0a90221eb61d7a5ad572cf405f092905bb67b /README.md
parent0293083811bdb0addf530ebe29014facc7d15b93 (diff)
Moved to markdown and updated text.
Diffstat (limited to 'README.md')
-rw-r--r--README.md102
1 files changed, 102 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..4fc25cef1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,102 @@
+# Remmina: The GTK+ Remote Desktop Client
+
+Initially developed by [Vic Lee](https://github.com/llyzs)
+
+## Description
+**Remmina** is a remote desktop client written in GTK+, aiming to be useful for
+system administrators and travellers, who need to work with lots of remote
+computers in front of either large monitors or tiny netbooks. Remmina supports
+multiple network protocols in an integrated and consistant user interface.
+Currently RDP, VNC, NX, XDMCP and SSH are supported.
+
+Remmina is released in separated source packages:
+* "remmina", the main GTK+ application
+* "remmina-plugins", a set of plugins
+
+Remmina is free and open-source software, released under GNU GPL license.
+
+## Installation
+
+### Binary distributions
+Usually remmina is included in your linux distribution or in an external repository.
+Do not ask for distribution packages or precompiled binaries here.
+This is a development site.
+
+### Ubuntu
+
+[Ubuntu ppa:remmina-ppa-team/remmina-next](https://launchpad.net/~remmina-ppa-team/+archive/ubuntu/remmina-next)
+
+To install it, just copy and paste the following three lines on a terminal window
+```sh
+sudo apt-add-repository ppa:remmina-ppa-team/remmina-next
+sudo apt-get update
+sudo apt-get install remmina remmina-plugin-rdp libfreerdp-plugins-standard
+```
+By default the RDP, SSH and SFTP plugins are installed. You can view a list of available plugins with `apt-cache search remmina-plugin`
+
+### From the source code
+
+Follow the following guides:
+
+* How to compile "next" branch on Ubuntu 14.04 and 14.10: [Compile-on-Ubuntu-14.04-and-14.10](Compile-on-Ubuntu-14.04-and-14.10)
+* How to compile "next" branch on Fedora 20: [Compile-on-Fedora-20](Compile-on-Fedora-20)
+* For Debian 7.6 you can use the Ubuntu guide, but you must disable SSH with -DWITH_LIBSSH=OFF when executing cmake. libssh provided with debian 7 (v 5.4) is older than the needed version 6.x.
+
+## Usage
+
+Just select Remmina from your application menu or execute remmina from the command line
+
+Remmina support also the following options:
+
+```sh
+ -a, --about Show about dialog
+ -c, --connect=FILE Connect to a .remmina file
+ -e, --edit=FILE Edit a .remmina file
+ -n, --new Create a new connection profile
+ -p, --pref=PAGENR Show preferences dialog page
+ -x, --plugin=PLUGIN Execute the plugin
+ -q, --quit Quit the application
+ -s, --server=SERVER Use default server name
+ -t, --protocol=PROTOCOL Use default protocol
+ -i, --icon Start as tray icon
+ -v, --version Show the application's version
+ --display=DISPLAY X display to use
+```
+
+## Configuration
+
+You can configure everything from the graphical interface or editing by hand the files under $HOME/.remmina or $HOME/.config/remmina
+
+## Contributing
+
+If you want to contribute with code:
+
+1. [Fork it](https://github.com/FreeRDP/Remmina#fork-destination-box)
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+If you want to contribute in other ways, drop us an email using the form provided in our web site.
+
+Soon you will be able to support us with a donation if you like.
+
+## Authors
+
+Remmina is maintained by:
+
+ * [Antenore Gatta](https://github.com/antenore)
+ * [Giovanni Panozzo](https://github.com/giox069)
+
+See the [AUTHORS](https://raw.githubusercontent.com/FreeRDP/Remmina/next/AUTHORS) for an exaustive list.
+If you are not listed and you have contributed, feel free to update that file.
+
+## Resources
+
+ * [Wiki and compilation instructions](https://github.com/FreeRDP/Remmina/wiki)
+ * [Mailing List](https://lists.sourceforge.net/mailman/listinfo/remmina-common)
+ * [Website](http://www.remmina.org)
+
+## License
+
+Licensed under the [GPLv2](http://www.opensource.org/licenses/GPL-2.0) license