Home Knowledge Blog Contact

Decentralized Web project

dWeb User program: Main tutorial on downloading, installing and running

1. Downloading and installing

Videos: Installing User software on - Windows / MacOS / Linux

The Decentralized web / dWeb program is available currently for 3 desktop platforms - Windows, Mac OS X, and Linux, and 1 mobile platform - Android. Installing on Android is done through one of the desktop platforms.


The utility for 64bit Windows was created and tested on Windows 7 and Windows 10. It is available for download on this link as a setup executable file - dweb-rel2a-windows64.exe

After downloading and saving the file to an appropriate folder please double click on file or open a 'command prompt' window, go to the folder and type -
> dweb-rel2a-windows64.exe

The setup program goes through installation and places files in the - 'c:\dweb' directory.
The program is started at boot time. It can also be started though:
- Start -> Programs -> dweb ->
- or, in 'file manager', in the 'c:\dweb' directory double click on - dweb2.exe
- or, open 'command prompt' and run - > c:\dweb\dweb2.exe


The utility for Mac OS X was created and tested on Mac OS X 10.11 / El Capitan and Mac OS X 10.15 / Catalina. It is available for download on this link as a self-extracting file - dweb-rel2a-macosx.run

After downloading and saving the file to an appropriate folder please open a 'terminal' window, go to the folder and type -
$ chmod +x dweb-rel2a-macosx.run
$ ./dweb-rel2a-macosx.run

This will create a 'dweb' sub-folder in the '/Users/Shared/dweb' folder .
The program is started at boot time. It can also be started though 'terminal':
$ /Users/Shared/dweb/dweb2
or, in 'Finder' file manager, in the '/Users/Shared/dweb/dweb2' folder double click on - dweb2



The utility for 64bit Linux was created and tested on Ubuntu 18.04 and Ubuntu 20.04. It is available for download on this link as a self-extracting file - dweb-rel2a-linux64.run

After downloading and saving the file to an appropriate folder please open a 'terminal' window, go to the folder and type -
$ chmod +x dweb-rel2a-linux64.run
$ ./dweb-rel2a-linux64.run

This will create a 'dweb' sub-folder in the /home/'user id'/ folder - ~/dweb .
The program is started at boot time. It can also be started though 'terminal':
$ ~/dweb/dweb2
or, in 'file manager', in the '~/dweb' folder double click on - dweb2



Installing on Android device requires connecting of the android device to a computer - through usb

Please complete the following steps -

->>>Step1 - enable your android device to be able to connect to your computer system / Enable developer options and USB debugging
developer.android.com/studio/debug/dev-options
--------------------------------
Enable developer options and USB debugging
Tap the Build Number option 7 times. in -
- Settings > About Phone > Build Number
- or, Settings > System > Advanced > About Phone > Build Number

Enable USB debugging
so your Android device can communicate with your development machine through Android Debug Bridge (adb).
--------------------------------

->>>Step2 - set up your computer system to detect your android device and connect both with usb cable
Download 'adb' program which is used to connect to android device, choose one of the following files based on the operating system -
windows, linux, or mac os/darwin. Unpack the zip file and find within all the files the needed 'adb' file.
platform-tools-latest-windows.zip platform tools Windows
platform-tools-latest-linux.zip platform tools Linux
platform-tools-latest-darwin.zip platform tools Mac OS
--------------------------------
macOS: No additional configuration required.

Ubuntu Linux: There are two things that need to be set up correctly: each user that wants to use adb needs to be in the plugdev group, and the system needs to have udev rules installed that cover the device.

Windows: need to Install a USB driver to connect to android device
developer.android.com/studio/run/oem-usb
--------------------------------
Troubleshooting: If the android device is not detected as an USB device by the computer please change the USB cable, and or check device options -.
developer.android.com/studio/run/device#developer-device-options

->>>Step3 - loading and running on device of the Android bridge program

The 'Decentralized web' project bridge/node software for Android device is installed through an initialization program under one of 3 platforms - Windows, Mac OS X, and Linux.

The initialization program downloads the bridge/node software for Android device and then loads it.

Start 'terminal' program (on Mac,Linux) or a 'command prompt' program (Windows), and go to the dweb install folder:
- on Windows - > cd c:\dweb
- on MacOS - $ cd /Users/Shared/dweb
- on Linux - $ cd ~/dweb


and start the init program -
dweb2 usr-brdg-init

Select 'load bridge program on android phone/tablet' then follow the prompts to complete installation.




2. First time run - creating decentralized identity

When starting the dWeb program for the first time the user has to establish identity based on an e-mail address. You can find more details and information about identity here - User identity and inviting other users

After starting the dWeb program for the first time it lanunches a web browser screen showing:

--------- Decentralized web - Create decentralized Identity ---------

For identity details please check - User ID
Requires Internet connection - turn on before clicking on button.

Type an e-mail address as user ID (up to 30 chars) _____________


an e-mail will be sent with a link to validate...

-------------------------------

Type an e-mail address that you choose as identity for the dWeb program, like for ex. - paul.arssov@sbcglobal.net . The dWeb program will follow with this browser screen:


--------- Decentralized web - Create decentralized Identity ---------

Sending an e-mail to validate Identity!
Open an e-mail client, read the message, and click on link to validate

The link is valid for 5 minutes. If not validated the program will exit.
Re-start again to create decentralized Identity

If not getting the e-mail, type another e-mail address as user ID (up to 30 chars) _________

an e-mail will be sent with a link to validate...

--------------------------------

Open your e-mail client or a web browser, and check the last messages that the chosen e-mail address , for ex. - paul.arssov@sbcglobal.net did receive. There should be a message:

validate e-mail

Click on the link in the message body - this will bring up a web browser or add a browser tab with the following message:


--------- Decentralized web - decentralized Identity validated ---------

Existing Identity -
Wallet account - 0x1234..........

Launching dWeb program

       ....Or...

Confirming e-mail validation !

Create new wallet account or assign existing wallet account
    ______________ - existing 0x... account address

   ______________ - password for new account address
    ______________ - repeat password
       [Create/Import account]

One of the fields has to be empty.
If creating a new account - type only password and leave address empty.
If importing existing account type account address and leave password empty.

(dWeb program does not store passwords; please store your password)
--------------------------------

You need to enter either an existing account address in the top field, or leave this field empty and type & re-type the password for your new account. A successful account creation will show:


--------- Decentralized web - account for decentralized Identity ---------

Created Identity -
Wallet account - 0x5678........

Launching dWeb program

--------------------------------

When a User installs the dWeb program for the first time they are rewarded with tokens in their account address.


3. Main screen

In addition to 'terminal'/'command prompt' window, When started the dWeb program shows this default graphical screen. A left mouse single click brings the initial menu. The menu toggles on and off with mouse clicks.

decentralized web user menu

The main items on the menu are -
- connect - select from a list of contacts
- ads on/off - starts/stops showing of ads
- invite - send an e-mail to invite another person to start communicating
- [menu] - brings a browser page with settings
- exit - closes this program and exits

     min - minimizes the main screen

4. Menu - settings

After clicking [menu] on main screen a browser tab is added showing the settings of the dWeb User program:

decentralized web user menu

The [Info] link reports the operating system, and the number of audio input and out output devices detected.

Next it reports the local and global IP addresses. For details on this please check - local and global IP address

The following line shows the e-mail address which was chosen and is used as identity for the dWeb program.

Finally and most importantly the dWeb program shows direction of communication - in this case it is outward only.

The so called here 'outward' IP communication is the standard 'client-server' mode of Internet communication.
While outward communication is always enabled and available for the user they can not receive inward request sent form another user residing outside of the local network.
Still, the user can enable inward IP communication.

For details on this please check -
outward and inward communication
testing outward and inward IP communication
enabling inward communication

A User can setup and run their own Bridge/node - and collect token rewards. In such case the inward communication has to be enabled for the Bridge/node.

While the User is a temporary participant in 'Decentralized web' a Bridge/node runs nonstop.

5. Adding contacts - sending invitations

Initially the 'connect' menu does not show any contacts. We have to send invitations to connect to other users of the dWeb program and then receive and accept invitations from other users.

When moving the mouse cursor over 'invite' and then clicking a new browser tab is launched -

invite menu
An email is set to the other User. When the other user opens their e-mail client or a web browser to read their e-mails they will see a message with:

From: contact@decentralizeweb.org Subject: dWeb contact message

After opening of the message the user who got the email invitation will see this -

invitation e-mail

A user who did not have the dWeb program can get familiar with it by clicking on the link - Instructions for installing and tutorial for running.

Then the user, depending on their operating system, can click on one of the package links to download and then install the dWeb program.

After saving of the received contact information an invitation replay e-mail is sent back to us as a confirmation for receiving our invitation and providing us with a contact information of the other user.

When we open our e-mail client or a web browser to read our e-mails we will see a message with:

From: contact@decentralizeweb.org Subject: dWeb contact replay message

After opening of the message we will see this -

invitation replay e-mail

Provided that either we or the other user, or both of us have enabled inward type of communication we can call each other and start communicating.

If the new contact is also a new User who just installed the User program and joined the 'Decentralized web' we will get a token reward for this and every other new User that we invited.


6. Connecting with other users - starting video+audio chat

After inviting users, getting the invitation accepted and receiving and confirming an invitation replay, there should be several contacts stored.

After clicking on the 'connect' in the main menu a new screen comes showing all of the stored contacts. If having more than 24 contacts the user can push 'next' and/or 'previous' to view the next or previous page with contacts listed.

connect menu

Clicking over one of the email addresses starts the connection sequence. The web camera is started and the local camera input is placed in the lower left side of the screen. A message is placed on screen - outgoing connection request and a choice to cancel the request.

If the user on the receiving side of the connection request did not start the dWeb program the connection request will stop and go to default screen after around 5 seconds.

outgoing connection request

If the user on the receiving side of the connection request did start the dWeb program they will get incoming connection request with message on screen - to accept or reject the request.

If the user on the receiving side of the connection request does not do anything the incoming connection request will stop and go to default screen after around 15 seconds.

In the same way the user who did initiate the connection request will get the request stopped and then go to the default screen after around 15 seconds.

If the user who did initiate the connection request clicks on 'cancel' , or the user on the receiving side of the connection request clicks on 'reject' both will get the request stopped and then go to the default screen right away.

If the user on the receiving side of the connection request clicks on 'accept' then both users will get video image from the other side placed on the top side of the screen and will get and send audio / sound information.

Clicking on screen while the communication is ongoing will bring a message on screen - 'hang up'. Clicking on it will terminate the communication on both sides.

7. Decentralized personal web site

When running the dWeb program, every user hosts their own web site which is visible to other users of the dWeb program. To find more about it please check -
Personal decentralized web site

The program comes with a default web site which looks like this -

decentralized web site

A User who did setup and is running their own Bridge/node can transfer their personal web site from the user's computer to the Bridge/node - through the [menu] page in the browser tab.

It this way the User's personal decentralized site will be available and running non-stop.


8. Viewing ads

When started the dWeb program shows this default screen. A left mouse single click brings the initial menu.

decentralized web user screen

Click on 'ads on/off' - this will bring the image of an ad, which can have from 1 to 5 pages.

Wait for 10-15s without doing anything. This will cause a timeout in the ads viewing and bring back the default screen. Do a left mouse single click to bring the initial menu and click again on 'show ads'.

1 page ad

Go over to the bottom/action area and click over '-->' . This will bring either the next page of the same ad or the next ad.

Go over to the bottom/action area and click over 'skip' - this will bring the next ad. Go over and click '-->' and '<--' - this will bring next or previous page of the ad.

Go over to the left side of the bottom/action area and click over the action text. For the 5 pages ad the action text is - "Platform details".

This will result in bringing up of a new tab in a web browser and loading the "action-url" page which is: "https://decentralizeweb.org/ad5.htm".

Users viewing ads will be continuously rewarded with tokens.


   Support our project - become our patron on Patreon:   Patreon - Decentralized Web

Back