• Stars
    star
    2,227
  • Rank 20,707 (Top 0.5 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created almost 6 years ago
  • Updated 4 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

⚡ File sharing progressive web app built using WebTorrent and WebSockets

Blaze - A P2P file sharing web app

Blaze - Fast peer to peer file sharing web app ⚡ | Product Hunt Embed Digital Ocean

Blaze is a file sharing progressive web app(PWA) that allows users to transfer files between multiple devices. It works similar to SHAREit or the Files app by Google but uses web technologies to eliminate the process of installing native apps for different devices and operating systems. It also supports instant file sharing with multiple devices at once which many file sharing apps lack.

Blaze primarily uses WebTorrent and WebSockets protocol (as a fallback) to transfer files between multiple devices. Files shared via WebTorrent are peer-to-peer(as they use WebRTC internally) which means there is direct transfer between the sender and receiver without any intermediate server. Do note that tracker servers in WebTorrent are used which carry metadata and facilitate the file transfer but do not get the complete file in any form.

Features

  • 💡 No account creation or signups.
  • 🚀 One-to-One and Many-to-Many file transfers.
  • 🔮 Works across different networks and devices.
  • ⚡ Easy to use, and no app installation required.
  • 📱 PWA for device-level integrations.

Try it out!

  • Go to a deployed client of Blaze - https://blaze.now.sh
  • Set a basic nickname(this is not stored on any server)
  • Create a new room. Room is where peers must join to share files among each other.
  • On another device, follow the above steps and join the same room. (Make sure to give a different nickname)
  • Both your devices should show up. Now start sharing some files!

Read more about how Blaze works at a basic level in this Medium article.

Deploy your own instance of Blaze

Deploy to DO Deploy

Read more on Deploying on your own server

Sponsors

Blaze is sponsored by:

Build process

  • For the frontend, webpack is setup internally via preact-cli. Overrides can be made in preact.config.js file.
  • For the backend, sucrase is used to transform ES modules imports/exports to CommonJS.
Environment variables

Following environment variables can be set in the build process:

variable description default
client Variables for client should be set as build args if using Docker.
WS_HOST URL to the server that is running the Blaze WebSockets server. 'ws://<your-local-ip>:3030'
SERVER_HOST URL to the server that running the Blaze HTTP server. 'http://<your-local-ip>:3030'
WS_SIZE_LIMIT Max file size limit when transferring files over WebSockets in bytes. 100000000 (100 MBs)
TORRENT_SIZE_LIMIT Max file size limit when transferring files over WebTorrent in bytes. 700000000 (700 MBs)
server
ORIGIN Array of string URLs to allow CORS. *
PORT Port for the server to run. 3030
WS_SIZE_LIMIT Max file size limit when transferring files over WebSockets in bytes. 100000000 (100 MBs)
DISABLE_SSE_EVENTS Disable server side events to reduce long-lived connections. false
TRUST_PROXY Whether server is behind a trusted proxy and can read forwarded IPs. false when standalone, true in docker-compose

NOTE: Any URL in the environment variables should not end with /.

Running Blaze in production

Blaze can be easily deployed on your own server using Docker and docker-compose. The frontend and the backend is completely decoupled from each other.

Docker images

Following Docker images are available:

  • Blaze Server: This is the backend Node.js server that is used for WebSockets communication. The environment variables listed for the server in previous section can be passed to the container. It exposes port 3030.

  • Blaze Client: This is the frontend progressive web app of Blaze used by clients for sharing files. Nginx is used as a web server for this statically generated frontend. The environment variables listed above must be passed as ARGS while building the image. The frontend container exposes port 80.

  • Blaze: This is a higher level image that includes both Blaze Server and Blaze Client images above. It must be used when docker-compose is not available in the environment, or there is a limit to run only a single container. docker-compose must be used to run Blaze in other cases which is explained in next section.

    Running high level Blaze image
    docker run -p 8080:80 -p 3030:3030 -e PORT=80 akashhamirwasia/blaze:latest

    NOTE: The PORT environment variable and the container port should be the same.(In the above example, it is set as 80).

Using docker-compose

A docker-compose.yml file is present at the root of this project which runs both the server and client containers and sets up a proxy for WebSocket connections on the frontend in Nginx configuration. To run using docker-compose:

git clone https://github.com/blenderskool/blaze
cd blaze
docker-compose up -d

Directly via Node.js

Building the frontend

npm run build:fe

The frontend built code would be located in the client/build directory.

Starting the server and frontend app

npm start

Blaze app can now be accessed at port 8080 🎉

Privacy and Analytics

  • Blaze server does not track or record the files that are being shared both by WebSockets and WebTorrent.
  • Any user related data like nickname, room names are always stored on device, and are only shared with the server when the user joins a room for file sharing.
  • Blaze client uses Google Analytics to record the following:

Contributing

Documentation on contributing can be found in CONTRIBUTING.md

License

Blaze is MIT Licensed

More Repositories

1

untab

🔍 A productivity tool to boost your browser workflow!
JavaScript
345
star
2

kaleidoscope

🍀 A small collection of creative nodes to generate color palette and store values for Blender
Python
118
star
3

pigmnts

🎨 Color palette generator from an image using WebAssesmbly and Rust
Rust
71
star
4

diode

🔌 Open-source API proxy server with an easy-to-use dashboard for configuring middlewares and secrets.
TypeScript
45
star
5

vyaakaran

📜 Visualize formal languages and automata
TypeScript
42
star
6

react-code-block

🧩 Set of unstyled UI components to build powerful code blocks in React.
MDX
32
star
7

color-pop

🌈 Automatic Color Pop effect on any image inspired by Google Photos
TypeScript
26
star
8

blender-depot-importer

📦 Importer add-on to batch install Blender add-ons from the Blender Depot platform
Python
21
star
9

mocktopus

🐙 AI powered CLI tool to generate mock data for anything!
Go
18
star
10

lexico

🔭 Powerful data searching with terse syntax
TypeScript
14
star
11

react-localstorage-hooks

🔄 A collection of React hooks for reactively managing localStorage.
TypeScript
10
star
12

ase-swatch

Create Adobe Swatch Exchange (ASE) Files for colors and palette
Rust
5
star
13

breathe

💧 Get Air Quality Data of any place in a very simplified interface
JavaScript
4
star
14

game-pay

💳 A simple payment app for board games using WebNFC
JavaScript
3
star
15

pencil

📝 Static documentation website generator using Markdown
JavaScript
3
star
16

clown-pass-blender

DEPRECATED. Clown Pass add-on for Blender would allow you to create a mask which shows every material with a separate color
Python
3
star
17

canvas-elements

🖌️ Library of commonly used components for HTML5 Canvas made easy to use
TypeScript
2
star
18

collect

This is a simple Savings Bank app which allows you to deposit and withdraw money
JavaScript
1
star
19

blenderskool-documentation

This was the documentation site of Blender Skool addons
HTML
1
star
20

react-places

JavaScript
1
star