Bugs General

[pavlobu]

If you saw or experienced a bug while using Deskreen. Drop it here. Please include Deskreen version!
If you saw a bug and know your dev environment, and how to reproduce it, please consider opening a new Issue labeled as Bug and provide full details.

[kernel0]

I use deskreen 1.0.3 with dummy plug adapter. Good connection but I can't watch my cursor on my third screen created by deskreen. Anything else is good.

[kernel0]

Also I tested two another configuration.
1.without dummy plug, first screen entire sharing -> ok. I watched the cursor.
2.without dummy plug, second screen (physical device) entire sharing -> no, I can't watch that.

[kernel0]

Last I tested with dummy plug and application sharing, watched cursor only but Application window is entire black (maybe not painted)

[pavlobu]

Try latest version

[kernel0]

1.0.3 too..

[pavlobu]

Have no clue,
Try to go through this:
#45

[kernel0]

reproduce it! (cursor disappear issue)

No.3 monitor is deskreen

working

not working.

not working

No.1 monitor resolution is 3440 * 1440 (primary monitor)
No2. monitor resolution is 1440 * 2560

maybe if x size is over (3440+1440) , not working
and if y size is over 1440, not working.

[pavlobu]

Did you read #45 ? Try doing this in chromium browser and test with a link in that issue (webrtc examples) if chromium also behaves like that, then it is a problem of chromium, let's wait when they will fix it and I'll update electron version to fix your problem later when it is ready

[pavlobu]

#45 (comment)

[pavlobu]

I have already fixed a problem like this by just updating chromium version, so if its a chromium issue, we can wait. Or you can submit this bug to chromium repo -> they fix it -> electron updates chromium engine -> we update Deskreen electron version and it will work finally

[pavlobu]

I noticed performance issues on Windows 10 when dragging Deskreen window

Will try to fix it soon

[easyt0re]

I'm using Win10 with version 1.0.4. The software just crashes all the time. I suspect it's because my laptop is too old. So I was wondering if some info on the "minimal requirement" of the hardware can be added.
This post is not really about reporting my crashes but I also feel like it's not a "new feature", so I just drop it here. I read the FAQ somewhere that the software does require some resources to run smoothly.

[easyt0re]

Maybe I should describe my experience more carefully. I can install and run the software, both the 1.0.4 I installed yesterday and the 1.0.5 portable I tried today. I'm using an iPhone 8 with Chrome (or Safari) as my "client/viewer". I almost always get past the "connect" step. Soon after that, my phone shows me "Deskreen Error Dialog: Something wrong happened".
Yesterday, with 1.0.4, the software started to "Not responding" or simply just froze at this point. Maybe "crashing" was the wrong word to use. I also experienced this "Not responding" directly after opening the software once. It's hard to kill even with the help of the task manager.
With cmd launching 1.0.5 portable, it's just a clean launch without any output. I just cd to the folder and use the file name to run it. I don't know if there is a more verbose way. This time I got as far as choosing apps to share. Yesterday, I didn't even see this because it's always empty. It wouldn't load the currently available apps. I actually got further to "confirm" today. But after I click that, it will again ask me to "reconnect", the same error as before.
With 1.0.5 portable, I also try to use another Win10 laptop as the viewer. Similar results happen. I can include a screenshot here. Everything was looking promising until this error shows up.

In general, the software responds to me quite slowly. After I click close, I have to wait one or two seconds for it to close. That's why I thought my system was probably too old for this. Idk. Maybe it's nothing.

[pavlobu]

@easyt0re Thank you for such a detailed explanation. Indeed I was able to reproduce this issue with a lowest configuration of Windows Virtual machine on which I'm testing Deskreen.
I will dig further to get rid of this problem in nearest future.

[pavlobu]

@easyt0re problem is that I was developing on powerful machine all the time. Now I get useful feedbacks and your feedback also helps. So now I will be working to eliminate these issues in future releases.
I didn't expect Windows will be such a pain and of course I got most of users on Windows ..

[pavlobu]

@easyt0re the app is a baby now. It is really hard to build a cross-platform app that works smooth on all platforms and versions of all operating systems from the very first release. Stay tuned for updates and this issue will be fixed, I plan to polish app by the end of Feb, there is a lot of work ahead

[pavlobu]

@easyt0re note that this does not happen on the same lowest machine config of linux. I have tested it on Linux Virt. machine. I also successfully ran Deskreen on my old RPI 3B+ it is really weak, but it worked on that board

[pavlobu]

Noticed a bug on 1.0.4 . The quality is NOT set for 100% by default when connection starts, will fix it asap.

The goal is to set 100% quality when connection starts. Right now it is set to AUTO

[pavlobu]

Fixed in 1.0.5 ⚡️
#100

https://github.com/pavlobu/deskreen/releases/tag/v1.0.5

[MaximoMachado]

I'm on v1.0.5 and everything was working great until today. For whatever reason, I'll connect my Windows desktop to a second screen from a dummy adapter on my linux laptop, put it into fullscreen, and after a couple minutes of use, the windows screen will freeze. The screen freezes for a bit before going black, and once I exit from fullscreen, it provides me with the error, WebRTC error occurred.

Each time I've been trying to reconnect it, the same thing occurs.

[pavlobu]

That is really strange. Looks. Like a flaky behavior. Try downgrading version to 1.0.0, or try windows portable 1.0.5 and tell if it helps.

Cheers

[pavlobu]

Also maybe reinstalling app may help

[MaximoMachado]

I restarted my laptop and so far it appears to be working. I'll report back if it's not just some freak one time occurrence.

Also, thanks so much for making Deskreen, it's solved a problem I was having for far too long. It's great being able to enter the land of two monitors again.

Edit: Just my luck, as soon as I wrote this I got the WebRTC error again. I'll try reinstalling and hopefully that helps out. For reference, I'm on Ubuntu.

[pavlobu]

Thanks! Enjoy using it. If you really think it may help others, please share it with them

Try if Appimage works ok on Ubuntu?

[MaximoMachado]

For whatever reason, restarting the computer that Deskreen was streaming over to fixed my issue. That probably means Deskreen wasn't at fault then; no clue why restarting the machine that isn't running Deskreen would fix things.

[ZhangTianrong]

Using 1.0.5, the app runs extremely slow (I mean navigating within the app window, setting up connection, etc) and chances are that there is no window or screen to select. Have tried previous versions, and similar issues exist. Sometimes when I start as Admin and the windows show up. Also, I have encountered this a few times, when it says something wrong happened on my phone but the allow/disallow dialog already shows up or the stream cannot be opened after I select the screen or window to share but deskreen isn’t aware of this. Furthermore it seems that screen keyboard can crush the problem sometimes?

[pavlobu]

Hi, thank you for providing us with these issues.
I have a clear goal on fixing this problem on windows before code signing is done.
#71 (comment)
I have a mid 2015 Mac only for development, I run Virtual Machine on Windows to test app there. So I'm pretty tight on resources.
I set a financial goal on opencollective to collect funds for buying a machine that I will use for Deskreen development on Windows and Linux. If you want to help you can contribute.

stay tuned for updates

[ivanbarlog]

Using macOS 11.2.1 (20D74) and v1.0.5 of Deskreen I am trying to connect over my home network to my Sony Bravia with it's internal web browser.

I am able to set up the connection but I am stuck at Waiting for user to seelct source to share from screen sharing device...

On my macbook I have already set up everything, I can see the My Device Info on TV and on my macbook as well -> they match. The Deskreen on macbook say "Success!" but the TV is still waiting.

I've tried this with another device (eg. phone) and it worked. I've also tried the localhost - worked as charm.

The TV and macbook are at the same WiFi network so that shouldn't be a problem. Seems like the browser on my TV is missing some essential functionality? But on macbook everything seems to be connected...

Is there any log I can paste here?

PS: The TV uses Vewd browser, unfortunately I cannot find the version...

PS2: This is what Deskreen says about the TV:

Device Type: computer
Device IP: ...
Device Browser: Opera 36.0.2128.0
Device OS: Linux armv7l
Session ID: ...

TV Model Name: KD-55XF7005
Software version: v8.885-1000-2.650-0000 (up to date)

[pavlobu]

Hi, I'm sorry but internal web browsers of smart TVs other than Chrome or Firefox are not supported, because they may not have support for WebRTC... :/

If you have an option to install Chrome or Firefox on your TV, then it will work, others have tried that already

Cheers

[ivanbarlog]

Thanks! I've read this statement within the FAQs after I've posted this ...

Unfortunately I am unable to install on the TV anything since it is not Androind TV.

Thanks anyway!

BTW: are you planning on supporting any other browsers? I've checked via https://www.webrtc-experiment.com/DetectRTC/ and it seems that there is Support for WebRTC but not for ORTC. I would paste the screenshot here but unfortunately cannot do that :-(

[hobojoe551]

So for some reason it just keeps freezing on me. The second I click yes to connect my device the desktop application just freezes. I am running popos currently. I am also using xrandr to make a virtual display, I am not sure if that is what is causing the issue. I'm not exactly sure what troubleshooting steps to go through, or if there is any more information needed. I have tried both the app image and the deb, and have gotten the same result from both.

[pavlobu]

Hi, you can try troubleshooting from here:
https://deskreen.com/#faq-4

[hobojoe551]

Yuup, those are all steps I took before even reading it. I did however figure out a way to get around the issue. If I maximize the window and the return it to normal size it unfreezes. It lets me continue from there too.

[pavlobu]

Cool, there are also play pause buttons in browser ui

[strannik19]

ubuntu 20.04. tried using both appimage and deb install. deskreen starts up, but is only listening on ipv6:

netstat -an | grep LISTEN | grep 3131                                                                                              
tcp6       0      0 :::3131                 :::*                    LISTEN

deskreen itself shows the ipv4 address

[pavlobu]

this will be fixed with allowing user to choose which network card to use in future releases.
the feature to allow user to type ip its own known ip address manually will also be added
it is a next thing in my todo list:
#71 (comment)

stay tuned for updates

Cheers,
Paul

[strannik19]

thanks! looking forward to have this working.

[Joseph-Hui]

Deskreen 1.0.11 + FluffyDisplay on MacOS Catalina KVM guest. When returning from screen lock, the Deskreen client is blank and does not show anything. Need to disconnect and reconnect again.

[danielporto]

Why is the security option grayed out and unavailable in General Settings (Deskreen for mac version 1.0.11) ?

[danielporto]

Is there a way to keep the URL?
I have another old Mac that I use as extra display, but every time it gets disconnected (change network, sleep) I need to type the URL again, it would be nice if the devices could be discovered automatically or at least have a way to make the URL static.

[metapea]

• Deskreen keep going on after exiting the program and went over 8gb of ram:
  
• It keep flashing on my desktop screen when i turn it on.
• the stream just stopped and i had to keep making new links for every couples of hours
  minor:
  -can you pleases improve the frame rate

[RBruyn]

Hi!
I'm having a problem when try to install in Debian the libappindicator was deprecated, how can I fix this ?

[royyhlee]

I'm using Opensuse tumbleweed + app image with Deskreen v1.0.12 I was able to figure out the server connection issue with this #48 (comment)

It is able to connect but my iPad safari keeps showing "WebRTC error occured" is there any way to fix this? I'd love to use this app!

EDIT:
I updated my ipad to the latest version and now it immediately shows "You were not allowed to connect" when I use the QR code

[smileR-T]

I used deskreen on X86 Linux system. The device is connected successfully, but sharing the whole screen fails.It is normal to share a separate window. The sharing screen is black and only one mouse is displayed. Please have a look ~

[jnoon417204]

@smileR-T I would appreciate any insights if you've managed to overcome this issue. I believe I am experiencing the exact same issue on x86 linux. When sharing apps, I can only share the deskreen application window; moreover, trying to share the entire screen results in a black screen wherein my mouse appears but only if it is within the borders of the deskreen application window.

[NRSingh007]

If you saw or experienced a bug while using Deskreen. Drop it here. Please include Deskreen version! If you saw a bug and know your dev environment, and how to reproduce it, please consider opening a new Issue labeled as Bug and provide full details.

Recently I downloaded Deskreen Version: 2.0.4 (2.0.4)
and when I tried to share the entire screen with or without a dummy HDMI plug the entire screen showed blank (BLACK)
I am using Ubuntu 22.04

working fine with app window

[tadeususman]

Hi There,

I also experienced it on my ubuntu 22.04.
and this is me browsing the internet, the reason is the wayland problem. by default wayland on ubuntu 22.04 is disabled. then I try to enable it. and I can share the entire screen.

for enable/disable wayland : https://linuxconfig.org/how-to-enable-disable-wayland-on-ubuntu-22-04-desktop

[openformoontribe]

Hi, not sure if this has already been pointed out yet. Downloaded deskreen, but had a WebRTC error. tried different devices. ipad and one of my phones didnt work. But another phone worked. Look for the difference in settings. Turns out to be the VPN. Turn off the VPN and it works.

[YeXin451664]

Deskreen如何修改启动的端口号？

[MGuerrera]

Using Deskreen 2.0.4 with BetterDisplay (create virtual monitors) on macOs Sonoma, it happens that when the screen saver starts due to inactivity, the virtual monitor on the browser where Deskreen is streaming freezes and turns black. At that point every time I have to close the browser tab and connect Deskreen again.

[Panashe-Tech]

Anyone who knows how to fix this issue. Deskreen cannot detect Wifi or Lan connection after upgrading to Windows 11 24H2

[milo-jo]

same issue

[ItsDevMacB]

Same

[citizenserious]

With Fedora 43 (KDE 6.5.3)
I am only seeing this since v3.0.1 last version tried v3.1.11 (rpm & AppImage)

Deactivating the firewall did not help.
I am connected to my network. Earlier versions (v2.x) did not have this specific issue.
Because I do not have any more information I didn't open an issue.
Does anyone know what's wrong here?
Thanks in advance (:

[pavlobu]

@citizenserious try this
https://github.com/pavlobu/deskreen?tab=readme-ov-file#linux

[pavlobu]

@citizenserious also please share ifconfig command output. you can xx.xxx.xx the IPs and Mac Adresses - I don't need them. i just need to see your system network device aliases what they called to figure out what breaks it

FYI here is the code for this logic. if your network device is not there, then it is probably the cause
https://github.com/pavlobu/deskreen/blob/master/src/main/helpers/getMyLocalIpV4.ts

[citizenserious]

Hey @pavlobu , thank you for instant reply (:

 ifconfig | grep "inet "
        inet 127.0.0.1  netmask 255.0.0.0
        inet 192.168.x.x  netmask 255.255.255.0  broadcast 192.168.x.255

maybe this also helps:

deskreen-ce --ip 192.168.x.x
18:50:11.513 › /opt/Deskreen CE/resources/app.asar/out/main/index.jsc : skipping desktop capturer auto refresh on wayland session
18:50:11.519 › /opt/Deskreen CE/resources/app.asar/out/main/index.jsc : Deskreen CE signaling server is online at port 3131
18:50:11.520 › /opt/Deskreen CE/resources/app.asar/out/main/index.jsc : 🌐 Server available at http://localhost:3131

I also tried it with the AppImage (using Gear Lever)

Unfortunately with the same behavior.

Possible relevant info: I get notified about Deskreen updates.

[citizenserious]

Yes you are right!
It has the name wlo1 on my system, which is missing in src/main/helpers/getMyLocalIpV4.ts
Sorry I didn't understand that you wanted the full ifconfig at fist.

ifconfig
lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets **removed**
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets **removed**
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

wlo1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 192.168.x.x  netmask 255.255.255.0  broadcast 192.168.x.255
        inet6 **removed**
        inet6 **removed** 
        inet6 **removed** 
        inet6 **removed**
        inet6 **removed**
        ether **removed** txqueuelen 1000  (Ethernet)
        RX packets **removed**
        RX errors 0  dropped **removed**
        TX packets **removed**
        TX errors 0  dropped **removed**

[pavlobu]

@citizenserious thank you for your input!
this is useful and with that I can try to fix the bug.

By the way, do you know any reliable source to get all possible names of the network device interfaces aliases in entire zoo of Linux distros ?
So I can add them all in the code

[citizenserious]

Ahh, awesome. Thank you very much!

Normally I would not post this, but I think this actually could be a good answer, so why not share it if it could benefit this project.
I asked an AI assistant for help with your question about network interface naming, because I had no idea (I am not a programmer). The following recommendation comes from the AI, not from me.
If this AI-based input is not welcome, please excuse it — I simply try to help with the tools available to me (:

---

There is no reliable or complete source for all possible network interface names across the Linux ecosystem. The set of names is effectively unbounded because interfaces are named by several independent components:

• Kernel defaults (eth0, wlan0, etc.)
• systemd “predictable names” (wlp2s0, enp3s0, wlo1, enx<MAC>, ...)
• Distribution-specific udev rules
• Custom admin-defined names in /etc/udev/rules.d/
• Virtual interfaces (docker0, virbr0, vethXXXX, tailscale0, ztXXXX, wg0, ...)

Because of this, maintaining a hardcoded allowlist like:

wlan0, wlan1, wlpXsY, wlo1, enpXsY, eth0, eth1, ...

…will always miss some real-world cases.

---

Recommended Approach

1. Enumerate all interfaces (Node.js)

Use os.networkInterfaces() and filter out only obviously virtual or loopback prefixes, such as:

lo, docker, veth, br-, virbr, tap, tun, wg, zt, vmnet

Then pick the first non-internal IPv4 address.

This approach is portable across distros and does not rely on naming conventions.

2. Optional: Determine the default-route IP

A more semantically correct approach is to detect the IP address of the interface used for the default route.

On Linux:

ip route get 1.1.1.1

The src field provides the actual outbound local IPv4.

Cross-platform npm packages like:

• default-gateway
• internal-ip

already implement this logic.

---

Maybe here comes the best part if it works :D

import os from 'os';

// Interfaces to skip completely (explicit names)
const IGNORE_INTERFACE_NAMES = [
  'lo',                           // Linux loopback
  'Loopback Pseudo-Interface 1',  // Windows loopback (common name)
];

// Interfaces to skip based on prefixes (virtual or container-related)
const IGNORE_INTERFACE_PREFIXES = [
  'lo',       // loopback
  'docker',   // Docker bridge
  'br-',      // Linux bridges
  'virbr',    // Libvirt/KVM virtual bridge
  'veth',     // Virtual ethernet peers
  'vmnet',    // VMware
  'zt',       // ZeroTier
  'tailscale',
  'wg',       // WireGuard
  'tun',      // TUN (virtual tunnel)
  'tap',      // TAP (virtual ethernet)
];

/**
 * Returns true if an IPv4 address is reasonable for LAN usage.
 * Excludes loopback (127.x.x.x) and link-local/APIPA (169.254.x.x).
 */
function isReasonableIPv4(address: string): boolean {
  if (!address) return false;
  if (address.startsWith('127.')) return false;      // loopback
  if (address.startsWith('169.254.')) return false;  // link-local (APIPA)
  return true;
}

/**
 * Returns true if the IPv4 address is part of private RFC1918 space.
 * This helps prefer true LAN IPs when multiple candidates exist.
 */
function isPrivateIPv4(address: string): boolean {
  const parts = address.split('.').map(Number);
  if (parts.length !== 4 || parts.some((n) => Number.isNaN(n))) return false;

  const [a, b] = parts;

  if (a === 10) return true;                        // 10.0.0.0/8
  if (a === 172 && b >= 16 && b <= 31) return true; // 172.16.0.0 – 172.31.255.255
  if (a === 192 && b === 168) return true;          // 192.168.0.0/16

  return false;
}

/**
 * Normalizes the network.family value to 'IPv4' | 'IPv6'.
 * Some environments historically used 4/6 instead of 'IPv4'/'IPv6'.
 */
function isIPv4Family(family: string | number): boolean {
  return family === 'IPv4' || family === 4;
}

/**
 * Attempts to determine the system's actual local IPv4 address
 * without relying on interface naming conventions.
 *
 * This approach:
 *  - Enumerates all interfaces from os.networkInterfaces()
 *  - Skips known virtual/loopback interfaces by name or prefix
 *  - Collects all valid, non-internal IPv4 addresses
 *  - Prefers private RFC1918 LAN addresses if available
 *
 * This is significantly more robust than hardcoding interface names
 * such as wlan0/wlp*/enp*/eth*, which vary across distros.
 */
export default function getMyLocalIpV4(): string | undefined {
  const networkInterfaces = os.networkInterfaces();

  const candidates: string[] = [];

  for (const [name, networks] of Object.entries(networkInterfaces)) {
    if (!networks || networks.length === 0) continue;

    // Skip obviously virtual or loopback interfaces
    if (IGNORE_INTERFACE_NAMES.includes(name)) continue;
    if (IGNORE_INTERFACE_PREFIXES.some((prefix) => name.startsWith(prefix))) {
      continue;
    }

    for (const network of networks) {
      if (
        isIPv4Family(network.family as string | number) &&
        !network.internal &&
        isReasonableIPv4(network.address)
      ) {
        candidates.push(network.address);
      }
    }
  }

  // No suitable IPv4 address found
  if (candidates.length === 0) {
    return undefined;
  }

  // Prefer private LAN addresses (typical home/office networks)
  const privateCandidate = candidates.find(isPrivateIPv4);
  if (privateCandidate) {
    return privateCandidate;
  }

  // Fallback: return the first reasonable IPv4 address
  return candidates[0];
}

[pavlobu]

thanks. yeah. AI is unreliable source.
i will try to figure it out in the next release

[pavlobu]

@citizenserious you can try this solution
#293