Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/metaprovide/nextcloud-swarm-plugin

Plugin for bridging Nextcloud and Swarm.
https://github.com/metaprovide/nextcloud-swarm-plugin

nextcloud nextcloud-app swarm

Last synced: about 1 month ago
JSON representation

Plugin for bridging Nextcloud and Swarm.

Host: GitHub
URL: https://github.com/metaprovide/nextcloud-swarm-plugin
Owner: MetaProvide
License: agpl-3.0
Created: 2021-09-25T16:09:27.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-10-18T14:22:15.000Z (2 months ago)
Last Synced: 2024-10-18T22:50:47.650Z (2 months ago)
Topics: nextcloud, nextcloud-app, swarm
Language: PHP
Homepage:
Size: 3.32 MB
Stars: 4
Watchers: 4
Forks: 0
Open Issues: 5
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# **Hejbit - Nextcloud Swarm Plugin**

*Bring decentralized, sovereign cloud storage to Nextcloud with the Hejbit Swarm plugin!*

This plugin integrates [Swarm](https://www.ethswarm.org/) (a decentralized, blockchain-connected file storage system) directly into your [Nextcloud ](https://nextcloud.com/)instance.

![File view when using the plugin in Nextcloud](https://github.com/user-attachments/assets/24f89fd9-f8eb-47e3-97ac-e1da41e48072)

## Table of Contents

- [Dependencies](#dependencies)
- [Setup and Installation](#setup-and-installation)
- [Usage](#usage)
- [Settings](#settings)
- [Usage](#usage)
- [Get Hejbit License](#get-hejbit-license)
- [License](#license)

## Dependencies

Before using the plugin, ensure you have the following:

- An active Nextcloud instance (version 27,28 or 29)
- A valid license and URL to activate the service
- [Request Your Free Nextcloud Swarm Plugin Trial License](https://metaprovide.org/hejbit/start)

## Setup and Installation

Follow these steps to configure Hejbit Swarm in Nextcloud:

1. Ensure the "External Storage" plugin is enabled.
2. Install the "External Storage: Hejbit Swarm" app from the Nextcloud App Store.
3. Navigate to External Storage Administration: Profile menu -> Settings -> External Storage.
4. Create a new external storage with a folder name of your choice and select 'hejbit-swarm' as the storage type. Then, enter the license key and URL configuration.

## Usage

Once installed, Hejbit Swarm integrates directly with Nextcloud’s "Files" section, allowing seamless file operations:

- **Upload:** Transfer files to decentralized storage.
- **Download:** Retrieve and view files from decentralized storage.
- **Copy/Move:** Shift files between any external storage and decentralized storage

![View, download, and file view actions in Nextcloud](https://github.com/user-attachments/assets/3bee08e4-7a9e-4b44-a904-821359cc3e7b)

### Settings

Users with administrative credentials can configure the plugin through the standard External Storage settings. Here, you can input your license key and URL for Hejbit Swarm.

![Basic Hejbit Swarm setup in External Storage in Nextcloud administration](https://github.com/user-attachments/assets/47e0cdda-5c1a-4464-a752-cf1eb5eeb19d)

### Usage

Once setup and configured, the Decentralized Storage is ready to use.

- Access the Decentralized Storage folder under "All Files" or via the "Files" menu under "External Storage."
- Upload files as you would in Nextcloud.

![Upload file to swarm in Nextcloud](https://github.com/user-attachments/assets/aadd664e-26ca-470a-a27b-af8d94351e52)

- Once uploaded, it can be viewed internally or downloaded. It can also be copied to another storage.

![View, download, and file view actions in Nextcloud](https://github.com/user-attachments/assets/596b72ed-d97f-48ba-bcb9-0ee5ff581a3c)

- Files from another Nextcloud storage can also be copied/moved to the decentralized storage.. Choose the decentralized storage folder as the target Folder

![Copying or moving files to decentralized storage folder](https://github.com/user-attachments/assets/ceed3585-f7e6-4f16-b371-d61402e9f1e9)

- Right-click on a Swarm file to copy the Swarm reference (hash) to your clipboard. Alternatively, click the three dots in the Actions menu and select 'Copy Swarm Reference.' The Swarm reference is the unique address of the file on the Swarm network.

![Copy swarm reference to clipboard](https://github.com/user-attachments/assets/cc73282b-e32e-411f-a94b-a2ac3313f60b)

### Get Hejbit License

Experience the future of data storage with 5GB of free, decentralized storage on the Ethereum Swarm network. Our plugin seamlessly integrates with your existing Nextcloud interface, providing true data sovereignty without the complexity.

[Get your free licence here!](https://metaprovide.org/hejbit/start) .

## License

This program is licensed under the AGPLv3 or later.