https://github.com/fabiodcorreia/catch-my-file

Send and Receive Files P2P
https://github.com/fabiodcorreia/catch-my-file

cross-platform file-sharing file-transfer filetransfer fyne fyneapp go golang linux-app mac-app p2p share share-files-under-same-wifi transfer-files windows-app

Last synced: 14 days ago
JSON representation

Send and Receive Files P2P

• Host: GitHub
• URL: https://github.com/fabiodcorreia/catch-my-file
• Owner: fabiodcorreia
• License: epl-2.0
• Created: 2021-06-30T09:06:14.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-03-21T14:00:04.000Z (about 2 years ago)
• Last Synced: 2025-03-23T18:11:27.953Z (about 1 month ago)
• Topics: cross-platform, file-sharing, file-transfer, filetransfer, fyne, fyneapp, go, golang, linux-app, mac-app, p2p, share, share-files-under-same-wifi, transfer-files, windows-app
• Language: Go
• Homepage: https://github.com/fabiodcorreia/catch-my-file
• Size: 595 KB
• Stars: 44
• Watchers: 3
• Forks: 12
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![catch-my-file logo](assets/icons/icon-512.png)

# Catch My File

Catch My File lets you easily send and receive files between peers on the local network.

## Why?

I wanted a tool that allows to:

- Share a files between peers without managing shared folders or file servers

- Auto discover other peers without looking for IPs and/or ports to connect

- Be indepemdent of the platform where it runs

- No need for configuration or user accounts, just run and share

## Features

- Discover other peers on the local network without any configuration

- Send specific files to specific peers

- Accept or reject files sent by other peers

- Follow the transfer progress

- Checksum (SHA256) verification of the file when transfer is completed

## Installation

- Download the latest [release](https://github.com/fabiodcorreia/catch-my-file/releases/latest) package

- Extract the package and run the application

- MacOS

    - Copy the application to the applications folder or just run it directly

    - On the frist run need to allow the app to run and make network connections

- Linux 

    - Run the command `sudo make install` to install the application

    - Run the command `sudo make uninstall` to remove the application

- Windows

    - Just run the executable

## Usage

### Peers Panel

This panel will show all the other peers using the application on the local network. Pressing send button we can select a file from the filesystem and send it to that peer.

![peers-view](assets/screenshots/peers-view.png)

### Sender

After the file is selected a checksum(SHA256) is generated and a file transfer request is sent to the target peer.

![prepar-for-sending](assets/screenshots/prepar-for-sending.png)

### Transfers Panel

After the request is send a record is added to the Transfers tab where the sender can follow the progress.

At the same time on the receiver side a similar record is added with the options to **Accept** or **Reject** the transfer, if rejected nothing will be transferred.

![receiver-view](assets/screenshots/receiver-view.png)

When accepted we select where on the filesystem the file will be stored and the transfer start.

![receiving](assets/screenshots/receiving.png)

The sender can also see the progress.

![sending](assets/screenshots/sending.png)

Once the transfer is completed on the sender side, the receiver will start the verification to insure the file integrity.

![verifying](assets/screenshots/verifying.png)

When the verification is completed with success the transfer will be completed.

![completed](assets/screenshots/completed.png)

## Built With

- [Go](https://go.dev/)

- TCP Sockets - Data transfer between the peers

- Go Modules

  - [Zeroconf](https://github.com/grandcat/zeroconf) - Service registration and discovery

  - [Fyne UI](https://fyne.io/) - Cross platform GUI inspired by Material Design

## Development

### Requirements

- (Dev) Go >= 1.16 - https://golang.org/

- (Build) Fyne - https://github.com/fyne-io/fyne

- (Release) Fyne-Cross - https://github.com/fyne-io/fyne-cross

## Changelog

The changelog can be founda at [CHANGELOG](CHANGELOG.md)

## License

Distributed under the Elipse Public License. See [LICENSE](LICENSE) for more information.