Skip to main content

IPFS browser

Project description

Galacteek

A modest IPFS browser

This is a standalone browser allowing you to search, browse, publish and hashmark content on the permanent web accessible through the IPFS peer-to-peer network.

Installation

PIP

You need to have python 3.5 and pip installed, as well as go-ipfs. 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

Docker image

Pull and run the latest Docker image from the Gitlab’s registry with:

docker pull registry.gitlab.com/galacteek/galacteek:latest
docker run -e DISPLAY=$DISPLAY -e QTWEBENGINE_DISABLE_SANDBOX=1 -v /tmp/.X11-unix:/tmp/.X11-unix registry.gitlab.com/galacteek/galacteek

Be sure to have proper permissions to the X server. If you get a connection refused message, just run xhost +. The media player won’t work with the Docker image.

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.

  • 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

Browsing the Wikipedia mirror over IPFS

Platforms supported

Mainly tested on Linux. The application relies heavily on quamash which should work with most platforms.

Contact and donations

Contact by email at galacteek@gmx.co.uk

Donations are welcome and will go to support other projects like ipfs-search. You can find donation details in the Donate section of the Help menu in the application’s main window.

Requirements

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

galacteek-0.2.1.tar.gz (1.6 MB view hashes)

Uploaded Source

Built Distribution

galacteek-0.2.1-py3-none-any.whl (1.9 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page