{{{
#!forumlinks
}}}

[[TracNav(DevelopersTOC)]]
= Architecture of Tribler =

== Component Overview (Clickable) ==
{{{
#!html
<p>
<img src="http://svn.tribler.org/bt2-design/how-tribler-works/trunk/core-arch.png" usemap="#arch.png">

<MAP NAME = "arch.png">
<AREA SHAPE = "RECT" COORDS = " 53,  33,  680,  71" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Main/tribler.py">
<AREA SHAPE = "RECT" COORDS = " 506,  92,  596,  132" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/Session.py">
<AREA SHAPE = "RECT" COORDS = " 94,  151,  301,  195" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/CacheDB/SqliteCacheDBHandler.py">
<AREA SHAPE = "RECT" COORDS = " 330,  151,  422,  191" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/APIImplementation/ThreadPool.py">
<AREA SHAPE = "RECT" COORDS = " 444,  153,  533,  191" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/APIImplementation/UserCallbackHandler.py">
<AREA SHAPE = "RECT" COORDS = " 571,  152,  662,  191" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/APIImplementation/LaunchManyCore.py">
<AREA SHAPE = "RECT" COORDS = " 52,  223,  99,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/NATFirewall/DialbackMsgHandler.py">
<AREA SHAPE = "RECT" COORDS = " 99,  222,  144,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/SocialNetwork/RemoteQueryMsgHandler.py">
<AREA SHAPE = "RECT" COORDS = " 144,  223,  188,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/Overlay/MetadataHandler.py">
<AREA SHAPE = "RECT" COORDS = " 189,  223,  256,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/BuddyCast/buddycast.py">
<AREA SHAPE = "RECT" COORDS = " 256,  223,  301,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Tribler/Core/SocialNetwork/SocialNetworkMsgHandler.py">
<AREA SHAPE = "RECT" COORDS = " 300,  224,  345,  262" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Tribler/Core/CoopDownload/CoordinatorMessageHandler.py">
<AREA SHAPE = "RECT" COORDS = " 367,  222,  450,  259" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/CacheDB/SqliteCacheDBHandler.py">
<AREA SHAPE = "RECT" COORDS = " 0,  281,  34,  322" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/CacheDB/SqliteCacheDBHandler.py">
<AREA SHAPE = "RECT" COORDS = " 52,  282,  173,  323" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/Overlay/OverlayThreadingBridge.py">
<AREA SHAPE = "RECT" COORDS = " 187,  282,  255,  323" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/Overlay/OverlayApps.py">
<AREA SHAPE = "RECT" COORDS = " 52,  342,  256,  383" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/Overlay/SecureOverlay.py">
<AREA SHAPE = "RECT" COORDS = " 299,  328,  384,  382" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/BitTornado/download_bt1.py">
<AREA SHAPE = "RECT" COORDS = " 408,  343,  476,  381" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/DecentralizedTracking/mainlineDHT.py">
<AREA SHAPE = "RECT" COORDS = " 477,  344,  545,  383" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/BitTornado/BT1/track.py">
<AREA SHAPE = "RECT" COORDS = " 263,  365,  296,  398" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/BitTornado/BT1/StorageWrapper.py">
<AREA SHAPE = "RECT" COORDS = " 52,  403,  545,  442" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/BitTornado/SocketHandler.py">
<AREA SHAPE = "RECT" COORDS = " 545,  403,  611,  442" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Core/NATFirewall/UPnPThread.py">
<AREA SHAPE = "RECT" COORDS = " 611,  403,  680,  442" HREF = "http://svn.tribler.org/abc/branches/mainbranch/Tribler/Video/VideoServer.py">
<AREA SHAPE = "DEFAULT" NOHREF>

</MAP>

}}}
''Boxes represent classes and arrows represent either "creates" or "calls" relationships. 
Note that we use the new term Torrent-Share to denote the per-torrent part of the download engine.'' 

=== Details ===

The following diagrams show the current architecture of Tribler in more detail. The originals can be found in [source:bt2-design/how-tribler-works/trunk svn:/bt2-design/how-tribler-works/trunk]


 * [http://svn.tribler.org/bt2-design/how-tribler-works/trunk/core-arch.pdf Overall Architecture of the Tribler Core]
 * [http://svn.tribler.org/bt2-design/how-tribler-works/trunk/torrentshare.pdf Download Engine]
 * [http://svn.tribler.org/bt2-design/how-tribler-works/trunk/vod.pdf Video On Demand]
 * [http://svn.tribler.org/bt2-design/how-tribler-works/trunk/arch.pdf Overall Architecture of the Tribler Main client] (to be updated)
 * [http://svn.tribler.org/bt2-design/how-tribler-works/trunk/gui.pdf GUI Architecture of the Tribler Main client] (to be updated)



== Extenstions to ABC / Bittorrent ==
The extensions we made to ABC/Bittorrent are all explained in [wiki:TriblerResearchSubjects the research section]. See the protocol specification in the left side-bar of this page for a detailed specification.

== Inner Workings of Bittornado ==
To accompany the architecture diagrams there is a detailed description of [/attachment/wiki/TriblerArchitecture/BitTornado-operation-20050916.pdf?format=raw   the inner workings of Bittornado](pdf).