galacteek 0.2.5

IPFS browser

info:

An async IPFS browser and exchanger

galacteek is an asynchronous Qt5-based browser and toolbox for the IPFS peer-to-peer network.

Installation

PIP

You need to have python>=3.5 (python>=3.6 is recommended) and pip installed, as well as go-ipfs. From a virtualenv, or as root, install with:

pip install galacteek

Or building it from source:

pip install -r requirements.txt
python setup.py build install

Now just run the application with:

galacteek

If you don’t have go-ipfs already installed, the application will ask you if you want to automatically download and install it from dist.ipfs.io You need a recent version of go-ipfs (> 0.4.7) with the new DAG API.

For the media player to work on Linux, you will need to install the gstreamer (1.x) package and all the gstreamer plugins.

Command-line usage

Use the -d command-line switch to enable debugging. Using –profile gives you the ability to have separate application profiles (main is the default profile). Use –help for all options.

Development: Use –monitor to enable event-loop monitoring with aiomonitor (install aiomonitor manually as it’s not a dependency). Then connect to the aiomonitor interface with nc localhost 50101

Features

galacteek can either spawn an IPFS daemon and use it as transport, or connect to an existing IPFS daemon. By default it will try to run a daemon. You can change the IPFS connection settings through the Edit -> Settings menu and restart the application afterwards.

Starting with the 0.2.5 release, your user profile has a dynamic DAG associated (with a simple message board), and an IPNS record points to the latest version of the DAG. The peers manager lets you browse the homepage of each peer.

• Browsing sessions with automatic pinning (pins every page you browse)

• Feeds (following IPNS hashes)

• File manager with drag-and-drop support

• Basic built-in media player with IPFS-stored, per-profile playlists

• Search content with the ipfs-search search engine

• Decentralized application development/testing with the Javascript API (using window.ipfs)

Keybindings

Main window keybindings:

• Ctrl+t: Open a new IPFS browsing tab

• Ctrl+w: Close current tab

• Ctrl+m: Open the IPFS hashmarks manager

• Ctrl+f: Open the file manager

• Ctrl+o: Browse IPFS path from the clipboard

• Ctrl+e: Explore IPFS path from the clipboard

• Ctrl+g: DAG view of IPFS object from the clipboard

Browser keybindings:

• Ctrl+b: Bookmark current page

• Ctrl+l: Load an IPFS CID

IPFS views keybindings (file manager, hash views, dag viewer):

• Ctrl+h: Copy selected item’s hash (CID) to the clipboard

• Ctrl+p: Copy selected item’s IPFS path to the clipboard

• Ctrl+w: Close tab/hash view

Screenshots

See the screenshots directory.

Browsing the Wikipedia mirror over IPFS

Platforms supported

Mainly tested on Linux. The application relies heavily on quamash which should work with most platforms. Things relying on HTTPs (ipfs-search engine queries ..) might not work on Windows due to ProactorEventLoop being incompatible with SSL. Manual installation of go-ipfs is advised on this platform.

Donations

You can find donation details in the Donate section of the Help menu in the application’s main window.

Requirements

• python3 >= 3.5.3 (it is strongly suggested to use python>=3.6 because asyncio is more mature and stable starting with python 3.6)

• go-ipfs > 0.4.7

• qt5

• PyQt5 with QtWebEngine support

• gstreamer (on Linux) for media player support

• quamash

• aiohttp

• aioipfs

License

galacteek is offered under the GNU GPL3 license

Some of the beautiful artwork (under the Creative Commons CC-BY-SA license) from the ipfs-logo project’s repository is included, unchanged.