Git Product home page Git Product logo

orbit-electron's Introduction

orbit-electron

Project Status

A distributed, peer-to-peer chat application built on IPFS

Desktop App for Orbit.

Currently works in OSX and Linux. We're working on Windows support.

NOTE! Orbit is still more or less experimental. It means Orbit is currently not secure, APIs will change and builds can break over the coming months. If you come across problems, it would help greatly to open issues so that we can fix them as quickly as possible.*

Built with:

  • orbit-web - UI for the application which can be used as fully working Orbit client in the browser.
  • orbit-core - Core Orbit communication library.
  • js-ipfs - IPFS, a new peer-to-peer hypermedia protocol.
  • electron - Electron

See also:

  • orbit-textui - Terminal client prototype for Orbit.
  • orbit-db - Serverless, p2p database that orbit-core uses to store its data.
  • IPFS - IPFS

Run

Download Binaries

Orbit binaries will soon be available from dist.ipfs.io. Meanwhile, you'll have to build the application from the source code.

Requirements

NOTE: Orbit requires a newer version of gcc to compile crypto libraries. gcc 6.2.1 has been tested successfully, gcc 4.9.2 is known to fail at runtime.

Standard gcc versions for various distros are listed below: Arch Linux gcc 6.2.1 Debian Stretch gcc 6.2.1 Debian Jessie gcc 4.9 RHEL7 gcc 4.8 Ubuntu 16.04 LTS gcc 5.3+ OSX Uses CLANG, not gcc. Verification needed.

Get the source code

git clone https://github.com/orbitdb/orbit-electron.git
cd orbit-electron/

Start the App

make start

or

npm install
npm start

Development

Run

NOTE! Before running this command, make sure you have orbit-web development server running

npm run dev

Build

Release

make build

or

npm run build

This will create binaries for OSX and Linux in bin/

Distributable Packages

make build
make dist

This will create bin/dist/orbit_master_darwin-amd64.tar.gz and bin/dist/orbit_master_linux-amd64.tar.gz and add them to IPFS.

Note: electron names the folders after the arch, and uses the x64 nomenclature instead of amd64. They are the same thing; we create tarballs with amd64 to match the golang distributions on ipfs/distributions.

Contributing

We would be happy to accept PRs! If you want to work on something, it'd be good to talk beforehand to make sure nobody else is working on it. You can reach us on IRC #ipfs on Freenode, or in the comments of the issues section.

A good place to start are the issues labelled "help wanted" or the project's status board.

License

MIT © 2015-2018 Protocol Labs Inc., Haja Networks Oy

orbit-electron's People

Contributors

haadcode avatar richardlitt avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.