summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorirungentoo <irungentoo@gmail.com>2013-07-19 10:57:23 -0400
committerirungentoo <irungentoo@gmail.com>2013-07-19 10:57:23 -0400
commit8a50c0472501f4d5ccf3714b7499fc1575c09a6c (patch)
treeea722441ef2bccb2ad8cb2bb82a1eab843bff528 /README.md
parentd792247dd8c5c4742f3d74fda3442e29da22467a (diff)
parent8744bcdc610994fd5ea83173bc53f52bc974d063 (diff)
Merge branch 'master' of https://github.com/irungentoo/ProjectTox-Core
Diffstat (limited to 'README.md')
-rw-r--r--README.md70
1 files changed, 31 insertions, 39 deletions
diff --git a/README.md b/README.md
index 1bd13fe4..8650ebde 100644
--- a/README.md
+++ b/README.md
@@ -1,40 +1,34 @@
1Tox 1![Project Tox](https://rbt.asia/boards/g/img/0352/79/1373823047559.png "Project Tox")
2=== 2Project Tox, _also known as Tox_, is a FOSS instant messaging application aimed to replace Skype.<br />
3 3
4[![Build Status](https://travis-ci.org/irungentoo/ProjectTox-Core.png?branch=master)](https://travis-ci.org/irungentoo/ProjectTox-Core) 4With the rise of governmental monitoring programs, Tox aims to be an easy to use application that allows people to connect with friends and loved ones without the worry of privacy.<br /> <br />
5 5
6Current IRC: #InsertProjectNameHere
7on Freenode or [webchat](https://webchat.freenode.net/)
8 6
9 7
10Proposal of a free as in freedom skype replacement:
11 8
12## Basics: 9**IRC**: #InsertProjectNameHere on Freenode, alternatively, you can use the [webchat](https://webchat.freenode.net/).<br />
10**Website**: [http://projecttox.org](http://projecttox.org)
13 11
14UDP must be used for everything simply because you can't do hole punching with TCP (well you can but it doesn't work all the time) 12
15 13
16Every peer is represented as a byte string (the client id) (It is the public key of the peer.). (if you want to add someone you need that id (either ask that person directly or maybe through some kind of search engine?)) 14## The Complex Stuff:
17 15+ Tox must use UDP simply because you can't hole punch with TCP. It's possible, but it doesn't work all the time.
18Use something torrent DHT style so that peers can find the ip of the other peers when they have their id. 16+ Every peer is represented as a byte string (the public key of the peer [client id])
19 17+ We're using torrent-style DHT so that peers can find the IP of the other peers when they have their ID.
20Once the client has the ip of that peer they start initiating a secure connection with each other.(See Crypto.) 18+ Once the client has the IP of that peer, they start initiating a secure connection with each other. (See [Crypto](https://github.com/irungentoo/ProjectTox-Core/blob/master/docs/Crypto.txt))
21 19+ When both peers are securely connect with the encryption, they can securely exchange messages, initiate a video chat, send files, etc.<br />
22When both peers are securely connected with the encryption they can securely exchange messages, initiate a video chat, send files, etc... 20+ Current build status: [![Build Status](https://travis-ci.org/irungentoo/ProjectTox-Core.png?branch=master)](https://travis-ci.org/irungentoo/ProjectTox-Core)
23
24Your client stores the public keys/id of the peers used to initiate the connection (this is your contacts list)
25 21
26## Roadmap: 22## Roadmap:
23- [x] Get our DHT working perfectly.(Done, needs large scale testing though.)
24- [x] Reliable connection (See Lossless_UDP protocol) to other peers according to client id. (Done, see DHT_sendfiletest.c for an example)
25- [x] Encryption. (Done)
26- [ ] Get a simple text only im client working perfectly. (This is where we are)
27- [ ] Streaming media
28- [ ] ???
27 29
281. Get our DHT working perfectly.(Done, needs large scale testing though.) 30For further information, check our [To-Do list](https://github.com/irungentoo/InsertProjectNameHere/blob/master/docs/TODO.txt).
292. Reliable connection (See Lossless_UDP protocol) to other peers according to client id. (Done, see DHT_sendfiletest.c for an example)
303. Encryption. (Done)
314. Get a simple text only im client working perfectly. (This is where we are)
325. Streaming media
336.
34 31
35## TODO:
36
37See: [docs/TODO.txt](https://github.com/irungentoo/InsertProjectNameHere/blob/master/docs/TODO.txt)
38 32
39### Important-stuff: 33### Important-stuff:
40 34
@@ -42,18 +36,16 @@ Use the same UDP socket for everything
42 36
43Keep everything really simple. 37Keep everything really simple.
44 38
45### Details: 39### Details and Documents:
46 40
47DHT protocol: 41[DHT Protocol](/docs/DHT.txt)<br />
48 see: [docs/DHT.txt](/docs/DHT.txt) 42[Lossless UDP Protocol](/docs/Lossless_UDP.txt)<br />
49 43[Crypto](/docs/Crypto.txt)<br />
50Lossless UDP protocol: 44[Ideas](/docs/IDEAS.txt)
51 Either we find one with an already working implementation (Didn't find a good implementation, writing my own)
52 see also: [docs/Lossless_UDP.txt](/docs/Lossless_UDP.txt)
53
54Crypto:
55 see: [docs/Crypto.txt](/docs/Crypto.txt)
56 45
57### Why are you doing this? There are already a bunch of free skype alternatives. 46### Why are you doing this? There are already a bunch of free skype alternatives.
58 47The goal of this project is to create a configuration free p2p skype
59see: [docs/WHY.txt](/docs/WHY.txt) 48replacement. Configuration free means that the user will simply have to open the program and
49without any account configuration will be capable of adding people to his
50friends list and start conversing with them. There are many so called skype replacements and all of them are either hard to
51configure for the normal user or suffer from being much too centralized.