[![](https://img.shields.io/liberapay/receives/Remmina.svg?logo=liberapay)](https://liberapay.com/Remmina/donate)
[![Build Status](https://gitlab.com/Remmina/Remmina/badges/master/build.svg)](https://gitlab.com/Remmina/Remmina/pipelines)
[![CodeTriage](https://www.codetriage.com/freerdp/remmina/badges/users.svg)](https://www.codetriage.com/freerdp/remmina)
[![Translation status](https://hosted.weblate.org/widgets/remmina/-/remmina/svg-badge.svg)](https://hosted.weblate.org/engage/remmina/?utm_source=widget)

# IMPORTANT NOTICE

Remmina is now here on [GitLab](https://gitlab.com/Remmina/Remmina)

As of the 1st of July 2018, the following links have to be used instead of respective GitHub counterparts.

* [Issues URL](https://gitlab.com/Remmina/Remmina/issues)
* [Wiki URL](https://gitlab.com/Remmina/Remmina/wikis/home)

# 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 or tiny screens. Remmina supports
multiple network protocols, in an integrated and consistent user interface.
Currently RDP, VNC, SPICE, NX, XDMCP, SSH and EXEC are supported.

Remmina is released in separated source packages:
* "remmina", the main GTK application
* "remmina-plugins", a set of plugins

Remmina is copylefted libre software, licensed GNU GPLv2+.

## Installation
Instructions for many operating system and building from source to be found [here](https://remmina.org/how-to-install-remmina/),
it can be edited on [the wiki](https://gitlab.com/Remmina/Remmina/wikis/home).

## Configuration

You can configure everything from the graphical interface, or editing by hand the files under $HOME/.remmina or $HOME/.config/remmina

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for a better overview.

If you want to contribute code:

1. Fork it
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 a new merge request

If you want to contribute in other ways, get in contact on IRC (#remmina on freenode), or send an e-mail using the form provided on the website.

### Donations

If you want to contribute to Remmina by sending money, you are more than welcome.
More info about this on [Remmina website donation page](https://remmina.org/wp/donations/).

See the [THANKS.md](THANKS.md) file for a list of all supporters.

## Authors

Remmina is maintained by:

 * [Antenore Gatta](https://gitlab.com/antenore)
 * [Giovanni Panozzo](https://gitlab.com/giox069)
 * [Dario Cavedon](https://gitlab.com/ic3d)

See the [AUTHORS](AUTHORS) for an exhaustive list.
If you are not listed and have contributed, feel free to update it.

## Resources

 * [Website](https://www.remmina.org/)
 * IRC room on freenode.net, in the #remmina channel, you can also use a [web client](https://kiwiirc.com/client/irc.freenode.net/?nick=remminer|?#remmina/).

## License

Licensed [GPLv2+](https://gitlab.com/Remmina/Remmina/blob/master/COPYING).