DWService - Docs

If there are two monitors on the remote device and your local device also has two monitors, and you would like to use both monitors simultaneously when managing the remote device, you need to do the following:

1. Visit our website: https://www.dwservice.net

2. Login to your account. You can read more about the login process here: Login

3. Your dashboard appears.

4. In your Dashboard, select Shares:

5. Create two separate shares for your Agent:

▶️ Our tutorial video on How to use Shares is available on our YouTube channel: DWService – How to use Shares (youtube.com)

💡 Hint 1: When creating a Share, you can give the Agent a more descriptive name (for example: Windows11 – Display1):

💡 Hint 2: When you create the share, you can set it to share only the Screen app:

💡 Hint 3: When creating the share, you have the possibility to share the Agent only for yourself:

Once you have created the two shares you can use them to connect.

6. Connect with one of the shares to the remote device, then in the toolbar, from the drop-down list, select Display1:

7. Then connect with the other share to the remote device as well, then in the toolbar, from the drop-down list, select Display2:

8. Display one browser window on one of your monitors and drag the other to the other one.

✅ This way you can use both remote monitors on your two local monitors at the same time.

💡 Hint: If you want to drag a window from one monitor to another you need to select the Extended display option from the toolbar and use this view:

 

▶️ Our tutorial video on How to use Shares is available on our YouTube channel:

If you would like to install the Agent on an older macOS device (for example El Capitan), the following error message window will appear during installation:

The reason for this error message is that your older macOS cannot handle this dwagent.dmg file properly.

The dwagent.dmg file contains two files: the installer (DWAgent.app) and a pdf file (IMPORTANT_NOTES.pdf):

➡️ This means that you need to access this DWAgent.app in the dwagent.dmg file in a different way.

There are two possible workarounds for this situation:

• In addition to your older macOS, you also have a newer macOS device.
• In addition to your older macOS, you also have a different (Windows or Linux) system.

---

In addition to the older macOS, you also have a newer macOS device

On the newer macOS device, open the downloaded dwagent.dmg file (with double click on it).

The following window will appear:

Right–click on the DWAgent.app file. Click on the Copy in the pop–up menu. As seen below:

This copies the file to the clipboard.

Then right-click in one of the folders on your system. For example, in the Desktop folder. In the menu that appears, click Paste Item. As seen here:

This will copy the DWAgent.app file to the current folder.

➡️ After this, transfer the extracted DWAgent.app file to your older macOS.

You have several options to do this. A few examples:

• using an USB drive (flash drive, external HDD, etc.)
• use an email attachment
• using a cloud service

➡️ On your older macOS, the Agent can already be installed.

💡 Our tutorial video on how to install the Agent is available on our YouTube channel:
DWService – How to install the Agent on Mac OS – YouTube

✅ Once installed, our service works fine.

---

In addition to the older macOS, you also have a different (Windows or Linux) system

If you have another device that runs Windows or Linux, you can also use 7Zip to extract the DWAgent.app from the dmg file.

➡️ Using 7Zip, extract the DWAgent.app file to another folder on your system. You can see the steps here:

Launch the 7Zip application and open the dwagent.dmg file. Then right-click on the DWAgent folder, and select Copy To… As seen here:

The following window appears:

Browse to the folder where you want to extract it.

Then click on the OK button.

➡️ After this, transfer the extracted item to your older macOS.

You have several options to do this. A few examples:

• using an USB drive (flash drive, external HDD, etc.)
• use an email attachment
• using a cloud service

➡️ On your older macOS, the Agent can already be installed.

💡 Our tutorial video on how to install the Agent is available on our YouTube channel:
DWService – How to install the Agent on Mac OS – YouTube

✅ Once installed, our service works fine.

 

If a user runs the Agent on a device where he/she has only user privileges, the Agent will also run with only user privileges.

If you would like to perform an operation remotely that requires administrator privileges, the window requesting administrator credentials will not appear to you (only to the remote user) because it is a protected window.

🧑🏼‍💻 The implementation of showing a password prompt window is also on our to–do list. Unfortunately, we cannot tell you when it will be available. But in the meantime, the workaround detailed below can be used.

Depending on whether the remote user knows the administrator password, or not, there are two possible scenarios:

• If the remote user knows the administrator password and enters it, and the Agent will run with administrator privileges.
• If the remote user does not know the administrator password, but you do, continue reading to find out how you can manage this situation.

---

The situation

The remote user asks you to connect to his/her device. To accomplish this, the remote user runs the Agent (with user privileges).

Then he/she shares the username and password with you. 

Connect to his/her Agent.

➡️ On the remote device, open the command prompt (cmd.exe) and enter the following command:

runas /user:administrator dwagent.exe

Then press Enter.

Note: this command runs the Agent as a different user.

⚠️ Of course, you must replace “administrator” with the username of the administrator on the remote device.

In the following example image, the administrator account name is DWService:

➡️ Then enter the password of the administrator.

⚠️ Important note: The remote user will not see what you type because you must enter the password blindly.

Once you have entered the password, press Enter.

Another instance of the Agent is launched.

➡️ Select Run and click on the Next button.

Then a window will pop up for the remote user (which you cannot see because it is a protected window). The remote user sees this window:

➡️ The remote user simply needs to click on the Yes button.

✅ You can then connect to the Agent with your new credentials (username and password). You will now have administrator privileges on the remote device.

🧑🏼‍💻 The implementation of printing is also on our to–do list, but not yet available.

In the meantime, the following workarounds can be used.

• Printing a remote document to a local printer
• Printing a local document to a remote printer

---

Printing a remote document to a local printer

✅ Using the Files and Folders application, download the document and print it on your local printer.

➡️ If the thing to be printed is not a specific document, you can follow these steps:

1. Print it to a pdf file on the remote device (using any pdf printer solution).
2. Download this pdf document to your device – using the Files and Folders app.
3. Print the pdf file on your local printer.

---

Printing a local document to a remote printer

✅ Using the Files and Folders application, upload the document and print it on the remote printer.

➡️ If the thing to be printed is not a specific document, you can follow these steps:

1. Print it to a pdf file on your local device (using a pdf printer solution).
2. Upload this pdf document to the remote device – using the Files and Folders app.
3. Print the pdf file on the remote printer (using the Screen application).

✅ Wayland support is now available and ready to use.
⚠️ However, there are currently some limitations.
📖 You can read more about these here: Wayland

If you decide to use X11 instead of Wayland, you can follow the instructions below.

There are two ways to set up the workaround:

• By using a command
• By using the graphical interface

---

Command

Open a Terminal window and type the following command:

sudo raspi-config nonint do_wayland <W1>

Press Enter.

Enter your password.

Press Enter.

⚠️ Note: you will not see the cursor move while typing. Regardless, type the password.

You can then verify that the setting is correct by using the following command:

echo $XDG_SESSION_TYPE

Press Enter.

If the result is X11, the setting is correct.

➡️ Restart the Raspberry.

✅ With this setting, our Screen application will also work properly.

💡 In case you would like to revert to Wayland using a command, use the following command:

sudo raspi-config nonint do_wayland <W2>

You can read about the command here: Raspberry Pi Documentation – Configuration

---

Graphical interface

Open a Terminal window and type the following command:

sudo raspi-config

Press Enter.

Enter your password.

⚠️ Note: you will not see the cursor move while typing. Regardless, type the password.

Press Enter.

The following window appears:

Select Advanced Options.

💡 Hint: use the arrow keys to navigate and press Enter to select.

The following menu appears:

Select Wayland.

Here you can change the system from Wayland to X11.

Use this option to switch between the X11 and Wayland backends. The Wayland backend was introduced in Bookworm, X11 was used in older versions of Raspberry Pi OS.

➡️ Switch to X11.

If the setting to X11 is done, restart the Raspberry.

✅ With this setting, our Screen application will also work properly.

🧑🏼‍💻 Implementing a feature that allows copying a folder is on our to–do list, but not yet available.

➡️ Therefore, until this feature is available, the following workaround can be used.

In this section, you can learn about:

• Upload a folder to the remote device
• Download a folder from the remote device

---

Upload a folder to the remote device

Zip the folder (on your device) you want to copy.
Right click on the folder that you would like to zip ⇒ Send to ⇒ Compressed (zipped) folder.

Name the file and press Enter.

A zip file is created in the same folder.

In the Files and Folders application use the Upload function to copy the zip file to the remote device:
1. Click on the Upload button.

The Upload window appears:
2. Click on the Choose a file text or drag the zip file into the window.

3. Click on the Upload button.

On the remote device (using the Screen application), unzip the zip file as follows:
Right click on the zip file ⇒ Extract All…

The following windows appears:
4. Select the Destination where you want to extract the folder.

5. Click on the Extract button.

---

Download a folder from the remote device

Zip the folder (on the remote device) you want to copy – using the Screen app.

Right click on the folder that you would like to zip ⇒ Send to ⇒ Compressed (zipped) folder.

Name the file and press Enter.

A zip file is created in the same folder.

In the Files and Folders application use the Download function to copy the zip file from the remote device:

1. Click on the Download button.

The zip file downloads to your device.

Unzip the copied zip file:

Right click on the zip file ⇒ Extract All…

The following windows appears:

2. Select the Destination where you want to extract the folder.

3. Click on the Extract button.

 

✅ Wayland support is now available and ready to use.
⚠️ However, there are currently some limitations.
📖 You can read more about these here: Wayland

If you decide to use X11 instead of Wayland, you can follow the instructions below:

1. Visit our website: https://www.dwservice.net

2. Login to your account. You can read more about the login process here: Login

3. Your dashboard appears:

4. Select Agents.

After selecting Agents, you will see your Agents:

5. Click on the Agent (which shows you the XWayland error message) to connect to it. You will see the applications:

6. Select the Files and Folders application.

The application opens:

7. Search for the following file: /etc/gdm3/custom.conf (or /etc/gdm/custom.conf):

8. Open the custom.conf file (double click on it).

The file opens in the Text Editor application:

9. Delete the # character from the beginning of the line WaylandEnable=false.

10. Click on the Save icon to save the file.

Close the applications window. You are back to your Agent.

11. Click on the 3 dot to open the menu.

12. Click on the Reboot OS.

After restarting the remote system, the Screen application will work.

✅ You can watch our tutorial video on the above setting on our YouTube channel:

🧑🏼‍💻 The implementation of several features is on our to–do list.

---

✅ As long as these functions are not available, temporary workarounds can be applied to certain situations.

🗒️ Currently, we are aware of the workarounds listed below.

📧 If you have information about other workarounds (not mentioned here), please let us know at support@dwservice.net. Thank you.

 

🛡️ Nowadays, personal information and data need to be protected more and more. Security and privacy are very important to us, which is why we have made it possible for everyone to use Two-Factor Authentication to protect their personal accounts.

⭐ In fact, we offer three different solutions (For details click on one of the links below):

• • TOTP (Time-based One-Time Password)
  • EMail
  • Device (Android)

✅ However, the effectiveness of your account protection is up to you. You need to enable one of these solutions.
We encourage you to activate it and take advantage of the enhanced protection.

💡 It is much better to prevent trouble, data loss and other harms. Do not let your personal data be exposed to an unauthorized person.

📧 If you have doubts, concerns, questions or any feedback, please feel free to contact us at support@dwservice.net.

TOTP

📖 More information on TOTP is available here: TOTP

A form of Two–Factor Authentication that can be selected when you enable Two–Factor Authentication.

To benefit from this 2FA protection, you need to enable Two-Factor Authentication as follows:

After signing in to your personal account, you will see these options:

1. Select My Account

Look for the Two–Factor Authentication section:

2. Click on the Enable button.

The following list appears:

3. Click on the TOTP

The following window appears:

Add a new authentication on your mobile device or in your app (You can find instructions here: TOTP):

• If you have a camera, use the QR code to add the authentication.
• Alternatively, or if you do not have a camera, enter the Secret (32 digits) below the QR code

Use your device or application to generate a code.

4. Enter the resulting code in the Code field.

5. Click on the Enable button.

The following window appears:

⚠️ Keeping the Unlock Code is extremely important. Keep it in a really safe place.

📖 You can read more about the Unlock Code here: Unlock Code

6. Click the Ok button.

✅ You have successfully set up your Android device as a Two–Factor Authentication device.

EMail

A form of Two–Factor Authentication that can be selected when you enable Two–Factor Authentication.

To benefit from this 2FA protection, you need to enable Two-Factor Authentication as follows:

After signing in to your personal account, you will see these options:

 

1. Select My Account

Look for the Two–Factor Authentication section:

 

2. Click on the Enable button.

The following list will appear:

 

3. Select the EMail option.

You will see the following window:

 

 

4. Enter in the Code field the 6-digit code that was sent to your email address.

5. Click on the Enable button.

If you have entered the correct code, you will see the following window:

 

6. Click on the Ok button.

✅ You have successfully activated Two-Factor Authentication via Email.

Device

A form of Two–Factor Authentication that can be selected when you enable Two–Factor Authentication.

You can enable it as follows:

• Download and install our Client for your Android device. You can find more information here: Client
• Add your account and sign into your account.

 

After signing in to your personal account, you will see these options:

 

1. Select My Account

You will see your device in the Authorized devices section:

 

After that, look for the Two–Factor Authentication section:

 

2. Click on the Enable button.

The following list will appear:

 

3. Click on the Device button.

The next window appears:

 

4. Select your device using the drop-down list.

5. Click on the Enable button.

Accept the request on your Android device.

Your Unlock Code appears:

 

⚠️ Keeping the Unlock Code is extremely important. Keep it in a really safe place.

📖 You can read more about the Unlock Code here: Unlock Code

Click the Ok button.

✅ You have successfully set up your Android device as a Two–Factor Authentication device.

Our subscriptions and invoicing are managed by our partner Paddle.

When you subscribe, you can currently choose between two payment methods:

• PayPal
• Card

To find out more about why we chose Paddle’s solution, you can read our blog here: DWService now available with a merchant of record – DWService – News