diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e43b0f9 --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +.DS_Store diff --git a/docs/media/screenshots/upload/Deluge/click-on-more.png b/docs/media/screenshots/upload/Deluge/click-on-more.png new file mode 100644 index 0000000..dae70a7 Binary files /dev/null and b/docs/media/screenshots/upload/Deluge/click-on-more.png differ diff --git a/docs/media/screenshots/upload/Deluge/download-finished.png b/docs/media/screenshots/upload/Deluge/download-finished.png new file mode 100644 index 0000000..8b48a46 Binary files /dev/null and b/docs/media/screenshots/upload/Deluge/download-finished.png differ diff --git a/docs/media/screenshots/upload/Deluge/download-start.png b/docs/media/screenshots/upload/Deluge/download-start.png new file mode 100644 index 0000000..81255bb Binary files /dev/null and b/docs/media/screenshots/upload/Deluge/download-start.png differ diff --git a/docs/media/screenshots/upload/Deluge/file-visualization.png b/docs/media/screenshots/upload/Deluge/file-visualization.png new file mode 100644 index 0000000..186c77e Binary files /dev/null and b/docs/media/screenshots/upload/Deluge/file-visualization.png differ diff --git a/docs/media/screenshots/upload/Deluge/move.png b/docs/media/screenshots/upload/Deluge/move.png new file mode 100644 index 0000000..de2177a Binary files /dev/null and b/docs/media/screenshots/upload/Deluge/move.png differ diff --git a/docs/media/screenshots/upload/QBittorrent/click-on-more.png b/docs/media/screenshots/upload/QBittorrent/click-on-more.png new file mode 100644 index 0000000..89994bc Binary files /dev/null and b/docs/media/screenshots/upload/QBittorrent/click-on-more.png differ diff --git a/docs/media/screenshots/upload/QBittorrent/download-finished.png b/docs/media/screenshots/upload/QBittorrent/download-finished.png new file mode 100644 index 0000000..48ed447 Binary files /dev/null and b/docs/media/screenshots/upload/QBittorrent/download-finished.png differ diff --git a/docs/media/screenshots/upload/QBittorrent/progress-bar.png b/docs/media/screenshots/upload/QBittorrent/progress-bar.png new file mode 100644 index 0000000..ca357f5 Binary files /dev/null and b/docs/media/screenshots/upload/QBittorrent/progress-bar.png differ diff --git a/docs/media/screenshots/upload/QBittorrent/save.png b/docs/media/screenshots/upload/QBittorrent/save.png new file mode 100644 index 0000000..285641d Binary files /dev/null and b/docs/media/screenshots/upload/QBittorrent/save.png differ diff --git a/docs/media/screenshots/upload/Transmission/click-on-add.png b/docs/media/screenshots/upload/Transmission/click-on-add.png new file mode 100644 index 0000000..71803c4 Binary files /dev/null and b/docs/media/screenshots/upload/Transmission/click-on-add.png differ diff --git a/docs/media/screenshots/upload/Transmission/download-finished.png b/docs/media/screenshots/upload/Transmission/download-finished.png new file mode 100644 index 0000000..838f052 Binary files /dev/null and b/docs/media/screenshots/upload/Transmission/download-finished.png differ diff --git a/docs/media/screenshots/upload/Transmission/download-start.png b/docs/media/screenshots/upload/Transmission/download-start.png new file mode 100644 index 0000000..acbb751 Binary files /dev/null and b/docs/media/screenshots/upload/Transmission/download-start.png differ diff --git a/docs/media/screenshots/upload/Transmission/move-file.png b/docs/media/screenshots/upload/Transmission/move-file.png new file mode 100644 index 0000000..f13c92e Binary files /dev/null and b/docs/media/screenshots/upload/Transmission/move-file.png differ diff --git a/docs/media/screenshots/upload/download-button.png b/docs/media/screenshots/upload/download-button.png new file mode 100644 index 0000000..2a7a679 Binary files /dev/null and b/docs/media/screenshots/upload/download-button.png differ diff --git a/docs/media/screenshots/upload/download-torrent.png b/docs/media/screenshots/upload/download-torrent.png new file mode 100644 index 0000000..988a14f Binary files /dev/null and b/docs/media/screenshots/upload/download-torrent.png differ diff --git a/docs/media/screenshots/upload/first-torrent.png b/docs/media/screenshots/upload/first-torrent.png new file mode 100644 index 0000000..fa70a97 Binary files /dev/null and b/docs/media/screenshots/upload/first-torrent.png differ diff --git a/docs/upload/deluge.md b/docs/upload/deluge.md new file mode 100644 index 0000000..0087ea9 --- /dev/null +++ b/docs/upload/deluge.md @@ -0,0 +1,51 @@ +# Documentation for Proper Use of the Deluge Client + +## Step 1: Access the Torrent Index + +First, go to [Torrust Demo](https://index.torrust-demo.com/torrents). + +## Step 2: Download the Desired Torrent + +Next, download the torrent you wish to use. Ensure that the torrent has seeders; otherwise, the download will be impossible. + +For this example, we will download the first torrent that appears (`debian-12.5.0-amd64-netinst.iso`). + +![First Torrent](/docs/media/screenshots/upload/first-torrent.png) + +Click on the download button. + +![Download Button](/docs/media/screenshots/upload/download-button.png) + +The torrent file will begin downloading. + +![Torrent Download](/docs/media/screenshots/upload/download-torrent.png) + +## Step 3: Open the Deluge Client + +Open your Deluge client. + +## Step 4: Add the Torrent to Deluge + +First, click on the "+" button. + +![click on more](/docs/media/screenshots/upload/Deluge/click-on-more.png) + +A file explorer will open. Here, you can either browse for the torrent file you downloaded or drag and drop it directly. Dragging and dropping is recommended due to potential issues with the client's file browser. + +![Move](/docs/media/screenshots/upload/Deluge/move.png) + +## Step 5: Confirm the Torrent + +Once the file is added, it will appear as shown below. + +![file visualization](/docs/media/screenshots/upload/Deluge/file-visualization.png) + +## Step 6: Start the Download + +Click "Add" to start the download. + +![Start the download](/docs/media/screenshots/upload/Deluge/download-start.png) + +Once the download is finished, right click on the torrent, click on open folder and the downloaded and converted file will appear. + +![download finished](/docs/media/screenshots/upload/Deluge/download-finished.png) diff --git a/docs/upload/qbittorrent.md b/docs/upload/qbittorrent.md new file mode 100644 index 0000000..78f7a01 --- /dev/null +++ b/docs/upload/qbittorrent.md @@ -0,0 +1,54 @@ +# Documentation for Proper Use of the Qbittorrent Client + +## Step 1: Access the Torrent Index + +First, go to [Torrust Demo](https://index.torrust-demo.com/torrents). + +## Step 2: Download the Desired Torrent + +Next, download the torrent you wish to use. Ensure that the torrent has seeders; otherwise, the download will be impossible. + +For this example, we will download the first torrent that appears (`debian-12.5.0-amd64-netinst.iso`). + +![First Torrent](/docs/media/screenshots/upload/first-torrent.png) + +Click on the download button. + +![Download Button](/docs/media/screenshots/upload/download-button.png) + + +The torrent file will begin downloading. +![Torrent Download](/docs/media/screenshots/upload/download-torrent.png) + +## Step 3: Open the Qbittorrent Client + +Open your Qbittorrent client. + + +## Step 4: Add the Torrent to Qbittorrent + +Click on the "+" button and select the torrent file you just downloaded. +![click on more](/docs/media/screenshots/upload/QBittorrent/click-on-more.png) + + + +## Step 5: Select the Download Location + +Choose the folder where you want to save the downloaded file. + +![save](/docs/media/screenshots/upload/QBittorrent/save.png) + +## Step 6: Start the Download + +Click "OK" to start the download. Wait for it to reach 100%. + + +![Progress size](/docs/media/screenshots/upload/QBittorrent/progress-bar.png) + +## Step 7: Locate the Downloaded File + +Once the download is complete, you can find the file in the folder you selected at the beginning. + +![download finished](/docs/media/screenshots/upload/QBittorrent/download-finished.png) + +The process is now complete. \ No newline at end of file diff --git a/docs/upload/transmission.md b/docs/upload/transmission.md new file mode 100644 index 0000000..7700f11 --- /dev/null +++ b/docs/upload/transmission.md @@ -0,0 +1,54 @@ +# Documentation for Proper Use of the Transmission Client + +## Step 1: Access the Torrent Index + +First, go to [Torrust Demo](https://index.torrust-demo.com/torrents). + +## Step 2: Download the Desired Torrent + +Next, download the torrent you wish to use. Ensure that the torrent has seeders; otherwise, the download will be impossible. + +For this example, we will download the first torrent that appears (`debian-12.5.0-amd64-netinst.iso`). + +![First Torrent](/docs/media/screenshots/upload/first-torrent.png) + + +Click on the download button. + +![Download Button](/docs/media/screenshots/upload/download-button.png) + +The torrent file will begin downloading. + +![Torrent Download](/docs/media/screenshots/upload/download-torrent.png) + +## Step 3: Open the Transmission Client + +Open your Transmission client. + +## Step 4: Add the Torrent to Transmission + +Drag and drop the downloaded torrent file into the Transmission client window. + +![Drag and Drop Torrent](/docs/media/screenshots/upload/Transmission/move-file.png) + + +## Step 5: Start the Download + +Click "Add" to start the download. + +![Click Add](/docs/media/screenshots/upload/Transmission/click-on-add.png) + + +The download will begin. + +![Download in Progress](/docs/media/screenshots/upload/Transmission/download-start.png) + + +## Step 6: Locate the Downloaded File + +Once the download is complete, access the folder where the file was saved. The downloaded torrent will be in `.iso` format. + +![Download Complete](/docs/media/screenshots/upload/Transmission/download-finished.png) + + + diff --git a/docs/upload/upload_torrents.md b/docs/upload/upload_torrents.md index 81a6ba4..0a78a3b 100644 --- a/docs/upload/upload_torrents.md +++ b/docs/upload/upload_torrents.md @@ -38,3 +38,8 @@ We allow uploading torrents with other custom fields, however those extra fields You can use the original infohash in URLs to navigate to the torrent details and you also have a list of original infohashes belonging to the same infohash group in the torrent details. If you think there is an important field missing in the `info` dictionary, please open an issue. + +## Upload using differents clients +- [Deluge](deluge.md) +- [QBittorrent](qbittorrent.md) +- [Transmission](transmission.md) \ No newline at end of file