DWService - Docs

ℹ️ Currently, the only way to financially support us is by subscription, donations are not possible.

💡 However, a subscription can give you the opportunity to support us without any long-term commitments.

🔢 Subscriptions do not necessarily have to be permanent; they can be ad hoc. This is how you can do it:

1. Subscribe to one of our monthly or annual plans.
2. After that, if you cancel your active subscription in your account, your subscription will not be renewed.
3. You can still use the higher bandwidth for the remaining period.

Note: the same applies to monthly and annual subscriptions. If you cancel it in your account, it will not be renewed, but you will still benefit until your subscription expires.

✅ So, you can use the subscription as a one-time payment. When and as much as you can afford.

😀 If you can afford it and would like to take advantage of the one-time subscription opportunity, we would greatly appreciate it.

ℹ️ Our service allows you to hide Desktop notification only.

📖 For more information about Desktop notification, please refer to our documentation which is available here: Desktop notification

⚠️ Important: The other parts of the Agent (system tray icon, DWAgent service, tasks in the Task Manager, etc.) cannot be hidden.

 

✅ Wayland is already supported.

ℹ️ However, there are limitations, and permission must be granted on the remote device.

---

Limitations

Currently, the limitations are the following:

• Capturing the login manager is not working yet (only with X11).
• Capturing the lock screen is not working yet (only with X11).
• There may be some Desktop Environments where screen capture does not work well. Because there are Desktop Environments where Wayland is still experimental.

⚠️ When using the Screen application, you may encounter one of the following error messages:

• If the remote device has the login manager ⇒ Error: Capturing the login manager screen is not allowed under Wayland.
• If the remote device has the lock screen ⇒ Error: Process closed (child status).

💡 If your problem is persistent, you might consider switching from Wayland to X11 temporarily until a permanent solution is found.
📖 For information on how to switch to X11, see the following documentation:

• 🖥️ Screen app – Error: XWayland is not supported – DWService – Docs
• 🖥️ Screen app – Error: XWayland is not supported – workaround for Raspberry – DWService – Docs

➡️ If you use Wayland and experience problems with the Agent, please let us know the details. For example: 

• The exact version of your operating system.
• The exact version of your Desktop Environment (KDE, Gnome, Cinnamon, Mate, etc.).
• Specifically what problem you are experiencing.
• If you get any error messages, what exactly are they?
• Possibly a screenshot of the problem.

📧 Please share the above details with us at support@dwservice.net. We will investigate the problem thoroughly and do all our best to find the solution or a temporary workaround.

✅ Thank you in advance for your cooperation.

---

Permission

ℹ️ On the remote device, in the case of Wayland, permission is required to capture the screen and to control it.

When connecting to the Agent, the following message is displayed: “You do not have permission to access protected windows. The screen is locked until the remote user unlocks this window.”

When someone connects to the Agent, a window will appear on the remote device.

• Example1: Gnome
• Example2: KDE Plasma

Gnome:

1. Tick the Remember This Selection checkbox.
2. Enable Allow Remote Interaction.
3. Enable Allow Clipboard Access.
4. Click on the Share button.

KDE Plasma:

1. Tick the Allow restoring on future sessions checkbox.
2. Click on the Share button.

✅ The window asking for permission will no longer appear when connecting to the Agent.

Based on feedback, it is rare, but it can happen that the loading of the page (for example when logging in) stops or freezes.

In this case, we suggest you check the following:

• Check the operation with another web browser. For example: Microsoft Edge, Google Chrome, Mozilla Firefox, Brave, etc.
• If your web browser has extensions/plugins, please temporarily disable all of them. If the login works correctly without extensions/plugins, it is one of the extensions/plugins that caused the problem. Then enable them one by one. After each enablement, check that our service still works properly. This way you can find out which extension/plugin caused your problem.
• If you have any Antivirus/Firewall protection, please turn them off temporarily. Then check that our service is working properly.
• If you are using Edge, Chrome, Firefox, etc. and the problem occurs, use the F12 function key to start DevTools. In the window that opens, select the Console tab. Check for errors (if any).
• If you are using a Safari browser and the problem appears, from the Develop menu, select Show Web Inspector and then the Console tab in the window that appears.
  In case you do not have a Develop menu in your Safari browser, proceed as follows:

1. Select Safari.
2. Select Settings…

The following window will open:

3. Select Advanced.
4. Tick the checkbox before the Show features for web developers.

5. Select Develop.
6. Select Show Web Inspector.

7. Select Console tab.
Check for errors (if any).

Most likely, one of the extensions is the cause.

If you have found out which extension, plugin, antivirus solution or other error caused your problem using the above methods, please let us know at support@dwservice.net

We would like to use this information to improve our service.

Thank you in advance for your cooperation.

 

ℹ️ Unfortunately, remote audio on macOS is not as simple as on Windows and Linux operating systems, where remote audio is already working after the Agent is installed.

Remote audio works with the most recent Agent. If you have an older version (you have set permissions to the dwagguilnc file), uninstall the old Agent, download the latest installer from our site and reinstall the Agent (and set the permissions to the DWAgentSvc.app file).

📖 To install the Agent and set up the permissions, you can find our recent documentation here: MacOS – DWService – Docs

➡️ If you have the most recent version of Agent installed on your device, you need to do the following:

Start your web browser (for example your Safari).

1. In the web browser, open the following web page: https://existential.audio/blackhole/

The web page will be displayed:

2. Click on the “I can’t afford to donate” button.

3 additional fields appear to fill in:

3. Enter your email address. (You will receive a download link to this email address).

4. Enter your First Name.

5. Enter your Last Name.

6. Click on the Send Link to Download button.

The following site appears:

Open your mailbox and check your inbox. You will see an email like this:

7. Click on the link. It opens the following site:

8. To download the application, click on the BlackHole 2ch button.

A confirmation window will appear:

9. You should click on the Allow button.

The file will be downloaded to your device. By default, to the Downloads folder.

Open the folder where the file was downloaded:

10. To install it, double–click on the icon.

The installer starts:

11. Click on the Continue button.

12. Click on the Continue button.

13. Click on the Agree button.

14. Click on the Continue button.

15. Click on the Install button.

16. Enter the password of your macOS user.
17. Click on the Install Software button.

18. Click on the Close button.

✅ The software installed successfully, but one more quick adjustment is needed.

Open Audio MIDI Setup (right click on Launchpad ⇒ Other ⇒ Audio MIDI Setup):

The window appears:

19. Click on the + (Plus) button.
20. Select Create Multi-Output Device.

21. Right click on the Multi-Output Device.
22. Select the Use This Device For Sound Output.

Select the devices.

✅ With this setting, the Agent will be able to capture the audio.

Note: If you no longer need this remote audio feature, to uninstall the BlackHole application, you can download the Uninstaller from here: Download BlackHole2ch Uninstaller

📧 If you have any feedback on macOS remote audio, please let us know at support@dwservice.net.

ℹ️ This section shows you the installation of the Agent for Linux step by step.

ℹ️ This section shows you the installation of the Agent for macOS step by step.

ℹ️ This section shows you the installation of the Agent for Windows step by step.

In case you choose this installation method, you should follow our next guide, step-by-step.

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

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

Your Dashboard appears:

2. Select Agents.

After selecting Agents, this will be displayed:

3. From the menu on the left, select the All.
4. Click the + (Plus) sign.

The following window will appear:

5. The selection of Group is optional.

• If you do not want to add the agent to a group, simply leave this field blank.
• If you want to add the Agent to a group, select the desired group from the drop-down menu. If there is no Group in the drop-down menu that suits you, you can create a new Group by selecting Groups in the Dashboard. For more details, click here: Groups.

6. Give a Name to the Agent you want to create.
7. Optionally, you can provide a Description of the Agent, which will help you to identify the Agent later.
8. To create the Agent, click on the Confirm button.
After the window closes, you will see this:

As you can see in the image above, the created Agent is displayed, which contains a generated Installation code. Each time you create an Agent, the system will generate such a code (consisting of numbers) for you. You must use this code during the Agent installation process.

After successfully creating the Agent, let’s see how to install the Agent.

Download the Agent installer for your device from our download page (https://www.dwservice.net/download.html).

Open the folder where you downloaded the Agent. By default, the Downloads folder.

9. Double–click on the downloaded dwagent.dmg file.

Another window appears on the screen:

10. Double–click on the DWAgent.app file.

Because you downloaded the file from the Internet, a security warning appears:

11. Click on the Open button.

A wizard will be launched to guide you through the installation.

12. From the options, select Install.
13. Click on the Next button.

A confirmation window will appear:

 

14. Enter the password of your MacOS.
15. Click on the OK button.

The Agent files are copied, installed, started.

The next page of the wizard is displayed:

16. From the two installation modes, select the Enter the installation code option.
17. Click on the Next button.

The next page of the wizard is displayed:

18. In this field, enter your Installation code. This is the code that the system previously generated for you when you created the Agent.
19. Click on the Next button.

The next page of the wizard is displayed:

As you can see, the Agent has been successfully installed.

20. Click on the Close button to close the wizard.

Once the installation is complete, you will also need to grant permissions to use the Agent. You can do this as follows:

21. Click on the Apple button in the top left corner of your screen.
22. Select System Settings…

The System settings window appears:

23. From the menu on the left, select Privacy & Security.
24. From the menu on the right, select Accessibility.

You will see the following window:

25. Click on the + (Plus) button.

A password prompt window will appear:

26. Enter your MacOS password.
27. Click on the Modify Settings button.

The following window will appear:

Select where the Agent is located (/Library/DWAgent/native/DWAgentSvc.app):
28. Select your Mac device.
29. Select the drive.
30. Select the Library folder.
31. Select the DWAgent folder.
32. Select native folder.
33. select the DWAgentSvc.app file.
34. Click on the Open button.

You will see the following window:

35. Click on the Back button.

The System settings window appears again:

36. Select the Screen & System Audio Recording option.

This will be displayed:

37. Click on the + (Plus) button.

The following window will appear:

Select where the Agent is located (/Library/DWAgent/native/DWAgentSvc.app):
38. Select your Mac device.
39. Select the drive.
40. Select the Library folder.
41. Select the DWAgent folder.
42. Select native folder.
43. Select the DWAgentSvc.app file.
44. Click on the Open button.

You will see the following window:

You can close the System settings window.

45. Click on the Monitor icon to show the DWAgent – Monitor window.

The DWAgent – Monitor window will appear:

In the image above you can see that the Agent is active and Online. From now on it is possible to connect to this Agent.
Now let’s go back to the account where you can see the Agent you created:

46. Select All from the menu on the left.

✅ The Agent is available and ready to use.

47. You can connect to the Agent by clicking on it.

Note: If you also need the remote audio function, you will need additional setup to use it. Our documentation, which guides you step-by-step through the setup process, is available here: How to set up remote audio on a remote macOS

This brings us successfully to the end of the installation process.
Use our service with maximum satisfaction. 😀

In case you choose this installation method, you should follow our next guide, step-by-step.

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

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

Your dashboard appears:

2. On your Dashboard, select My Account.

After selecting My Account, this will be displayed:

3. From the menu on the left, select Account.
4. Enter the Agent installation password, which you will be asked to enter when you install the Agent.
📖 You can read more about the Agent installation password here: Installation password
⚠️ Important: For security reasons, this password cannot be the same as your account password. Choose a different password.
5. To save the password, click on the Update credentials button.

The following window will appear:

6. Click on the Ok button.

Now let’s see how to install the Agent.

Download the Agent installer for your device from our download page (https://www.dwservice.net/download.html).
Open the folder where you downloaded the Agent. By default, the Downloads folder.

7. Double–click on the downloaded dwagent.dmg file.

Another window appears on the screen:

8. Double–click on the DWAgent.app file.

Because you downloaded the file from the Internet, a security warning appears:

9. Click on the Open button.

A wizard will be launched to guide you through the installation.

10. From the options, select Install.
11. Click on the Next button.

A confirmation window will appear:

12. Enter the password of your MacOS operating system.
13. Click on the OK button.

Then the wizard appears again:

14. From the two installation modes, select the Creating a new agent option.
15. Click on the Next button.

The next page of the wizard is displayed:

16. Enter your DWService account username (your email address)
17. Enter the Agent installation password. You have previously set this up in your account in the Credentials section. ⚠️ Important: this is not your account password.
18. Enter a name for the Agent you want to create.
19. Click on the Next button.

The next page of the wizard is displayed:

As you can see, the Agent has been successfully installed.
20. Click on the Close button to close the wizard.

Once the installation is complete, you will also need to grant permissions to use the Agent. You can do this as follows:

21. Click on Apple icon.
22. Select System Settings…

The System settings window appears: 23. From the menu on the left, select Privacy & Security.
24. From the list on the right, select Accessibility.

You will see the following window:

25. Click on the + (Plus) button.
A password prompt window will appear:

26. Enter your MacOS password.
27. Click on the Modify Settings button.

The following window will appear:

Select where the Agent is located (/Library/DWAgent/native/DWAgentSvc.app):
28. Select your Mac device.
29. Select the drive.
30. Select the Library folder.
31. Select the DWAgent folder.
32. Select native folder.
33. Select the DWAgentSvc.app file.
34. Click on the Open button.

You will see the following window:

35. Click on the Back button.

The System settings window appears again:

36. Select the Screen & System Audio Recording option.
Note: On systems prior to macOS Sequoia (macOS15), this menu item is Screen Recording.

You will see this:

37. Click on the + (Plus) button.

The following window will appear:

Select where the Agent is located (/Library/DWAgent/native/DWAgentSvc.app):
38. Select your Mac device.
39. Select the drive.
40. Select the Library folder.
41. Select the DWAgent folder.
42. Select native folder.
43. Select the DWAgentSvc.app file.
44. Click on the Open button.

You will see the following window:

You can close the System Settings window.

45. Click on the Monitor icon to show the DWAgent – Monitor window.

The DWAgent – Monitor will appear:

In the image above you can see that the Agent is active, and the status is Online. From now on it is possible to connect to this Agent.

Now let’s go back to the account where you can see the Agent you created:

46. In the menu on the left, select All.
47. The Agent is available. As you can see, the agent created is not in a group, nor does it have a description. If you don’t need these, we are now at the end of the process. The Agent is ready for use.

You can connect to the agent by clicking on it.

The following steps are optional:

If you would like to put the Agent in the group and/or add a description to it, please do the next few steps:

48. Click on the three dots in the top right corner of the Agent. This will open the menu of the Agent.
49. From the menu that appears, select Edit.

You see the Edit window of the Agent:

50. The selection of Group is optional.

• If you do not wish to add the agent to a group, simply leave this field blank.
• If you want to add the Agent to a group, select the desired group from the drop-down menu. If there is no Group in the drop-down menu that suits you, you can create a new Group by selecting Groups in the Dashboard. For more details, click here.

51. Optionally, you can provide a Description of the Agent, which will help you to identify the Agent later.
52. To save the changes, click on the Confirm button.
After the window closes, you will see this:

✅ The Agent is available and ready to use.

Note: If you also need the remote audio function, you will need additional setup to use it. Our documentation, which guides you step-by-step through the setup process, is available here: How to set up remote audio on a remote macOS

This brings us successfully to the end of the installation process.
Use our service with maximum satisfaction. 😀