fs-gtk.rst (5743B)
1 .. _GTK-User-Interface: 2 3 GTK File-sharing User Interface 4 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 5 6 This chapter describes first steps for file-sharing with GNUnet. To 7 start, you should launch ``gnunet-fs-gtk``. 8 9 As we want to be sure that the network contains the data that we are 10 looking for for testing, we need to begin by publishing a file. 11 12 .. _gtk_002dPublishing: 13 14 Publishing 15 ^^^^^^^^^^ 16 17 To publish a file, select \"File Sharing\" in the menu bar just below 18 the \"Statistics\" icon, and then select \"Publish\" from the menu. 19 20 Afterwards, the following publishing dialog will appear: 21 22 .. image:: /images/gnunet-gtk-0-10-fs-publish.png 23 24 In this dialog, select the \"Add File\" button. This will open a file 25 selection dialog: 26 27 .. image:: /images/gnunet-gtk-0-10-fs-publish-select.png 28 29 Now, you should select a file from your computer to be published on 30 GNUnet. To see more of GNUnet's features later, you should pick a PNG or 31 JPEG file this time. You can leave all of the other options in the 32 dialog unchanged. Confirm your selection by pressing the \"OK\" button 33 in the bottom right corner. Now, you will briefly see a \"Messages\...\" 34 dialog pop up, but most likely it will be too short for you to really 35 read anything. That dialog is showing you progress information as GNUnet 36 takes a first look at the selected file(s). For a normal image, this is 37 virtually instant, but if you later import a larger directory you might 38 be interested in the progress dialog and potential errors that might be 39 encountered during processing. After the progress dialog automatically 40 disappears, your file should now appear in the publishing dialog: 41 42 .. image:: /images/gnunet-gtk-0-10-fs-publish-with-file.png 43 44 Now, select the file (by clicking on the file name) and then click the 45 \"Edit\" button. This will open the editing dialog: 46 47 .. image:: /images/gnunet-gtk-0-10-fs-publish-editing.png 48 49 In this dialog, you can see many details about your file. In the top 50 left area, you can see meta data extracted about the file, such as the 51 original filename, the mimetype and the size of the image. In the top 52 right, you should see a preview for the image (if GNU libextractor was 53 installed correctly with the respective plugins). Note that if you do 54 not see a preview, this is not a disaster, but you might still want to 55 install more of GNU libextractor in the future. In the bottom left, the 56 dialog contains a list of keywords. These are the keywords under which 57 the file will be made available. The initial list will be based on the 58 extracted meta data. Additional publishing options are in the right 59 bottom corner. We will now add an additional keyword to the list of 60 keywords. This is done by entering the keyword above the keyword list 61 between the label \"Keyword\" and the \"Add keyword\" button. Enter 62 \"test\" and select \"Add keyword\". Note that the keyword will appear 63 at the bottom of the existing keyword list, so you might have to scroll 64 down to see it. Afterwards, push the \"OK\" button at the bottom right 65 of the dialog. 66 67 You should now be back at the \"Publish content on GNUnet\" dialog. 68 Select \"Execute\" in the bottom right to close the dialog and publish 69 your file on GNUnet! Afterwards, you should see the main dialog with a 70 new area showing the list of published files (or ongoing publishing 71 operations with progress indicators). 72 73 .. _gtk_002dSearching: 74 75 Searching 76 ^^^^^^^^^ 77 78 Below the menu bar, there are four entry widges labeled \"Namespace\", 79 \"Keywords\", \"Anonymity\" and \"Mime-type\" (from left to right). 80 These widgets are used to control searching for files in GNUnet. Between 81 the \"Keywords\" and \"Anonymity\" widgets, there is also a big 82 \"Search\" button, which is used to initiate the search. We will ignore 83 the \"Namespace\", \"Anonymity\" and \"Mime-type\" options in this 84 tutorial, please leave them empty. Instead, simply enter \"test\" under 85 \"Keywords\" and press \"Search\". Afterwards, you should immediately 86 see a new tab labeled after your search term, followed by the (current) 87 number of search results --- \"(15)\" in our screenshot. Note that your 88 results may vary depending on what other users may have shared and how 89 your peer is connected. 90 91 You can now select one of the search results. Once you do this, 92 additional information about the result should be displayed on the 93 right. If available, a preview image should appear on the top right. 94 Meta data describing the file will be listed at the bottom right. 95 96 Once a file is selected, at the bottom of the search result list a 97 little area for downloading appears. 98 99 .. _gtk_002dDownloading: 100 101 Downloading 102 ^^^^^^^^^^^ 103 104 In the downloading area, you can select the target directory (default is 105 \"Downloads\") and specify the desired filename (by default the filename 106 it taken from the meta data of the published file). Additionally, you 107 can specify if the download should be anonymous and (for directories) if 108 the download should be recursive. In most cases, you can simply start 109 the download with the \"Download!\" button. 110 111 Once you selected download, the progress of the download will be 112 displayed with the search result. You may need to resize the result list 113 or scroll to the right. The \"Status\" column shows the current status 114 of the download, and \"Progress\" how much has been completed. When you 115 close the search tab (by clicking on the \"X\" button next to the 116 \"test\" label), ongoing and completed downloads are not aborted but 117 moved to a special \"\*\" tab. 118 119 You can remove completed downloads from the \"\*\" tab by clicking the 120 cleanup button next to the \"\*\". You can also abort downloads by right 121 clicking on the respective download and selecting \"Abort download\" 122 from the menu. 123 124 That's it, you now know the basics for file-sharing with GNUnet! 125 126