Read Me

     //
  /////u  // //         craftware        ===============
   //    // //         utilities        	ViaVoip    
  // // // // // //                    ===============     
 // // //  yt ///    www.utillyty.eu
             //							
				Copyright (C) 2015 Attilio Pavone <tilly@utillyty.eu>

A peer to peer voice chat.

				Version 0.5, 15/03/2015
				

Release notes
=============
This is the first experimental Android porting.
Some improvements in the chat section (html formatted messages and notifications).


Install
=======
You can get viavoip at http://sourceforge.net/projects/viavoip/.

--- Windows ---
Extract the archive and launch "ViaVoip.exe" (no setup required).

--- Linux ---
Extract the archive and launch "ViaVoip" (no setup required).
NB: requires Qt 4.7.0 or later.

--- Android ---
In order to setup the apk it is necessary
1) check the options "Settings/Security/Unknown Sources";
2) open the downloads folder through a file manager
   (and not the "downloads" link), and tap on ViaVoip-0.5.apk
3) accept the security requirements (most of them are unused, but I should have 
   specified it in the app manifest, and this is to much work for a prototype!)


Usage
=====

--- Network ---

* As server:
  - in the "Network" tab, "Server" section, select the local IP from the list 
    (NB: 127.0.0.1 is only for test purpose in the host machine and should not be used);
  - specify a local port (better if >= 1024, but not mandatory, depends on the host system);
  - click the start service button (the first on the top left) and wawit incoming call.
    NB: in order to receive incoming calls it can be necessary to set your router
      NAT (port forwarding) accordingly (both TCP and UDP protocol must be allowed
      on local port).
  - click the public IP discovery button, and tell it to your peer together 
    with local port
  - accept the incoming call
    NB: once connected the server is paused.
    
* As client (peer):
  - in the "Network" tab, "Peer" section, put in the "Remote IP" and "Remote Port"
    the numbers that your peer told you based on the above paragrah.
  - click the call button and wait for the Server to accept.
  
Once connected "client" and "server" behave in the same way.
  
--- Audio ---

- in order to speak push the mic button in the "Audio" tab
- in order to heare your peer voice push the headphones button in the "Audio" tab.

--- Chat ---

- use the "S" button (Alt + 's') to send a message.
- use the "F" button (Alt + 'f') to send a file.


Licence
=======
GNU General Public License version 3 (see LICENSE.txt).