riptide-transfer 1.3.6__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,176 @@
1
+ Metadata-Version: 2.4
2
+ Name: riptide-transfer
3
+ Version: 1.3.6
4
+ Summary: Direct, encrypted PC-to-PC file transfer in the terminal. No cloud upload, no website in the data path.
5
+ Author: riptide
6
+ License: MIT
7
+ Requires-Python: >=3.11
8
+ Description-Content-Type: text/markdown
9
+ Requires-Dist: textual>=0.86
10
+ Requires-Dist: cryptography>=42
11
+ Requires-Dist: paramiko>=3.4
12
+
13
+ # Riptide
14
+
15
+ Riptide is a terminal program for direct, encrypted, PC to PC file transfer. Run `riptide` in a folder, connect two computers, and send files from one to the other over one encrypted TCP connection. Files go straight from sender to receiver. No server stores a copy in between.
16
+
17
+ The name comes from Minecraft. Riptide is the trident enchantment that launches the player forward at high speed. With an Elytra in rain, Riptide plus Elytra is the fastest travel method in Minecraft. Riptide the program aims for the same idea for files: the shortest route, from one PC to the other.
18
+
19
+ ## Screenshots
20
+
21
+ ![Homepage](docs/screenshots/homepage.png)
22
+
23
+ ![Create Server page](docs/screenshots/create-server.png)
24
+
25
+ ![Join Server page](docs/screenshots/join-server.png)
26
+
27
+ ![File transfer page](docs/screenshots/transfer.png)
28
+
29
+ ## Features
30
+
31
+ - Direct session between two PCs. One side listens, the other dials in. Both sides must be online at the same time.
32
+ - Either side can send files after the session opens. File direction does not depend on connection direction.
33
+ - Multiple file selection. Select files with Space, send the batch with Enter.
34
+ - File manager with folders, live search in `Find:`, auto-highlight of the first file or folder, and `0` to deselect all.
35
+ - File requests with approval. Type a peer path, press Enter, and nothing is sent until the peer presses Allow.
36
+ - Saved connections. Peers, hostnames, and certificate fingerprints are saved in `~/.riptide/config.toml`. Saved devices appear on the Join Server page.
37
+ - Automatically add firewall rule for inbound connections.
38
+ - Live progress with speed, transferred total, remaining size, and ETA, on sender and receiver.
39
+ - Hash verification. Each file is SHA-256 hashed before sending, written as `.part` on receipt, and renamed only if the hash matches.
40
+ - TLS encryption for headers and file bytes, with per-machine self-signed certificates.
41
+ - Fingerprint approval. First connection to a peer shows its certificate fingerprint for approval. A changed fingerprint later aborts the session.
42
+ - Public address display on Create Server.
43
+
44
+ Security, in brief: TLS protects files in transit. Fingerprints authenticate peers, and first connect shows a 6-digit code to compare out of band. Download requests need explicit approval. Private keys stay in `~/.riptide/` at 0600 and are never stored in `config.toml`. Files on disk are not encrypted. A push after session approval does not ask per file, but it never overwrites, duplicates are saved as (1), (2), etc., so only approve sessions for peers you trust. Full detail is in [Docs/Security](docs/security.md).
45
+
46
+ ## Installation
47
+
48
+ Published on PyPI as `riptide-transfer`. The command stays `riptide`.
49
+
50
+ Requirements: Python 3.11 or newer, Windows or Linux. For the GitHub install you also need `git`.
51
+
52
+ ```sh
53
+ pip install riptide-transfer
54
+ ```
55
+
56
+ Or install from GitHub:
57
+
58
+ ```sh
59
+ pip install git+https://github.com/mohakps/riptide
60
+ ```
61
+
62
+ Run it from the folder you want to send from or receive into:
63
+
64
+ ```sh
65
+ riptide
66
+ ```
67
+
68
+ Update:
69
+
70
+ ```sh
71
+ pip install --upgrade riptide-transfer
72
+ ```
73
+
74
+ Uninstall:
75
+
76
+ ```sh
77
+ pip uninstall riptide-transfer
78
+ ```
79
+
80
+ If upgrade fails, uninstall and install again.
81
+
82
+ ## Usage
83
+
84
+ Create Server listens. Join Server dials. Create stays on top in the menu.
85
+
86
+ 1. Create side: run `riptide`, choose Create Server, and share the public address shown on that page or your DDNS hostname with the other person. Keep the page open.
87
+ 2. Join side: run `riptide`, choose Join Server, enter the host hostname or IP, or pick a saved device, and press Enter.
88
+ 3. Approve the connection when asked, on either side.
89
+ 4. Send: select files with Space in the file manager, press Enter. Request: type a peer path in Download From Peer, press Enter, and wait for the peer to Allow it.
90
+ 5. Files arrive in the folder where the receiving side ran `riptide`.
91
+
92
+ If you are behind CGNAT, swap roles. Let the other side Create, and you Join. Full usage, shortcuts, and setup steps are in [Docs/Usage](docs/usage.md). Learn more about CGNAT or who should create server in [Docs/Architecture](docs/architecture.md).
93
+
94
+ ### Shortcuts
95
+
96
+ | Key | Action |
97
+ | --- | --- |
98
+ | Up / Down | Move in a list |
99
+ | Space | Open a folder, or select a file |
100
+ | Enter | Send selected files, or Allow a pending connection |
101
+ | Backspace | Erase Find text, go up a folder when Find is empty, or Deny a pending connection |
102
+ | 0 | Deselect all files |
103
+ | Tab | Cycle between file list and download input |
104
+ | Esc | Back, or leave the session |
105
+
106
+ ## Advantages
107
+
108
+ - One direct transfer, at bottleneck speed. No server in the middle to slow, throttle, or queue it.
109
+ - About half the time of a cloud transfer for large files. Cloud transfer is upload plus download. Direct transfer is one transfer.
110
+ - No account, storage quota, or file size limit from Riptide. Disk space is the limit.
111
+ - No third party holds a copy, so privacy does not depend on a provider policy.
112
+ - LAN speed when both PCs are on the same LAN, using a private LAN address.
113
+
114
+ Full details in [Docs/Advantages](docs/advantages.md).
115
+
116
+ ## Limitations
117
+
118
+ - First setup on the Create side: port forward 50000 on the router, once, and DDNS if the public IP changes often. The PC firewall rule for port 50000 is checked and added automatically when you click Create Server, on Windows and Linux. If Riptide is not run as admin, or sudo needs a password, it asks once on that click: UAC on Windows, pkexec on Linux. If you cancel, or it cannot add the rule, the Create page shows the exact manual command. Only rules that explicitly mention port 50000 are checked and opened. Any-port rules are ignored.
119
+ - No direct connection between two CGNAT devices on IPv4, unless both have global IPv6. There is no relay fallback.
120
+ - Folders cannot be sent yet. Zip a folder first, or select its files one by one.
121
+ - No resume for an interrupted file. It restarts from the start.
122
+ - One file at a time, in batch order. No parallel streams.
123
+ - Both sides must be online together. No offline queue.
124
+ - You must exchange the host address outside Riptide, by message or DDNS hostname.
125
+ - Terminal only, Windows and Linux primarily. macOS is not specifically tested.
126
+
127
+ Full detail, with workarounds where they exist, is in [Docs/Limitations](docs/limitations.md).
128
+
129
+ ## Project structure
130
+
131
+ ```
132
+ riptide/
133
+ ├── src/riptide/
134
+ │ ├── app.py
135
+ │ ├── theme.py
136
+ │ ├── screens/
137
+ │ │ ├── menu.py
138
+ │ │ ├── create.py
139
+ │ │ ├── join.py
140
+ │ │ └── session_screen.py
141
+ │ └── core/
142
+ │ ├── session.py
143
+ │ ├── identity.py
144
+ │ ├── nat.py
145
+ │ ├── config.py
146
+ │ ├── file_select.py
147
+ │ ├── firewall.py
148
+ │ ├── focus.py
149
+ │ └── transfer.py
150
+ ├── tests/
151
+ ├── REMOVED.md
152
+ └── README.md
153
+ ```
154
+
155
+ For detail structure, read [Docs/Project structure](docs/project-structure.md).
156
+
157
+ ## How this was built
158
+
159
+ - Meta Muse: primary assistant for panning, implementation, testing, and documentation.
160
+ - Gemini 3.8 Flash: TUI Design
161
+
162
+ Human decisions, testing on real machines, and final choices about names, ports, and behaviour are the author's. AI-generated code was tested, not trusted blindly. The test suite and headless Textual pilots are part of the workflow, and live two-machine testing is what proves a transfer.
163
+
164
+ ## Future Scope
165
+
166
+ - Support for transferring folders
167
+ - Support for MacOS
168
+
169
+ ## Docs
170
+
171
+ - [Architecture](docs/architecture.md)
172
+ - [Security](docs/security.md)
173
+ - [Advantages](docs/advantages.md)
174
+ - [Limitations](docs/limitations.md)
175
+ - [Troubleshooting](docs/troubleshooting.md)
176
+ - [Sources and references](docs/sources-references.md)
@@ -0,0 +1,23 @@
1
+ riptide/__init__.py,sha256=FfdeLLk-f0b2Npqs_XmsjbDt7gCq04ZZCBj_xvLwaZg,797
2
+ riptide/__main__.py,sha256=pyuShe1147W4ZVJVoj3KP7jGDBq2uxK11pchF60RpHU,79
3
+ riptide/app.py,sha256=RGpJuInPybEcCyl9hBgmY3jtZnXAsvvgNyFM7AaCpnw,1056
4
+ riptide/theme.py,sha256=OMzQV7qv3epd-jV7vTg2XwJx1YD0Nk-FZEywhsRPnnk,22428
5
+ riptide/core/__init__.py,sha256=69VKywsEoEFfAjee80WEZ6D-kLQ0y8fZ7qJnbXA1G2o,38
6
+ riptide/core/config.py,sha256=fNPwywg-M_ckD_jyoOFP8rBztTBRmlmn_g6mUQdJMXY,6689
7
+ riptide/core/file_select.py,sha256=ee2-psspjfy8IQ7dVg6V_D1Sebsqb3wRNxGZHH5kDaw,2486
8
+ riptide/core/firewall.py,sha256=AbmryjiZC5RPpsSWHbevDFTg7xeMbVPWVRu46FvNUJY,20941
9
+ riptide/core/focus.py,sha256=pTTknOsELuv3gmSQHDAHHTQj7s9DEYicV0hdB8sVwEE,2580
10
+ riptide/core/identity.py,sha256=NDco5c5vDYEUT3ecZMU6KnmwvkzrWc2etkGRFbGpuLA,9855
11
+ riptide/core/nat.py,sha256=b9QLNz1UUzKJvT196EXPag61_0nutWTbDWKmrUZ70gk,3602
12
+ riptide/core/session.py,sha256=p5BoxHxs4GlJMlIeemt4leyJVtolYLFIGWWPM_w2BUk,37228
13
+ riptide/core/transfer.py,sha256=UbEiSCyIA-ztwUe1MMIdETbPyup2u2tInTc1TwgrCDA,2515
14
+ riptide/screens/__init__.py,sha256=zZ7dnvb3SRO9lzNTH75SmjxxJcCpreOg1eU9-7DCJ1w,35
15
+ riptide/screens/create.py,sha256=bPbYHgV1oHWxTdtfYzIQMVginrbi8vDcA2FdEBUm7cw,23020
16
+ riptide/screens/join.py,sha256=ywNyO2TebsPxYUkGuJN-7dl7Oz_VfnUvytVCTxUSi4E,19101
17
+ riptide/screens/menu.py,sha256=fMwHvNE8IpA-ng00v5u8ii4ZT7W5Uz_3EJGKrFepWgA,4096
18
+ riptide/screens/session_screen.py,sha256=rzRqr7Mpokbq-0bCroh7-K4kqqZTsBX80-qOoBPO-QA,46252
19
+ riptide_transfer-1.3.6.dist-info/METADATA,sha256=x07Nz704V_3eclcovYLk3r71zkRAikLmw6urZSFO0-I,8021
20
+ riptide_transfer-1.3.6.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
21
+ riptide_transfer-1.3.6.dist-info/entry_points.txt,sha256=xHeTiJYrYcVsxxvwhzmiK0b5II2K2gVByqlK0MChHec,45
22
+ riptide_transfer-1.3.6.dist-info/top_level.txt,sha256=ZunbZWoW59c6fzldWsap9hLNkZSKDpDcpQTyq2B5kjE,8
23
+ riptide_transfer-1.3.6.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (84.2.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ riptide = riptide.app:main
@@ -0,0 +1 @@
1
+ riptide