TTFDesk Setup Guide | TouchToFix

Download TTFDesk

⊞ Windows 64-bit Installer (.exe) ⌘ macOS Intel x64 Disk Image (.dmg) ⌘ macOS M1/M2/M3 Apple Silicon (.dmg) 🐧 Linux x64 AppImage (no install)

ℹ️ TTFDesk is only needed when your expert requests full keyboard & mouse control. For screen viewing only, the FixMe Portal works in any browser — no download needed.

Installation & First Launch

1

Download & Run the Installer

Double-click TTFDesk-Setup-1.0.0-win-x64.exe. Windows may show a SmartScreen warning — click "More info" → "Run anyway". The installer asks for Administrator permission (required for keyboard & mouse injection).

2

Follow the Installer

Accept the default install path (C:\Program Files\TTFDesk) or choose your own. Click Install → Finish. TTFDesk launches automatically and appears in the system tray (bottom-right near the clock).

3

Allow Firewall Access

Windows Firewall may prompt to allow TTFDesk — click Allow access for both Private and Public networks. This is needed for the WebRTC video stream.

4

You're Ready

The TTFDesk window opens. Proceed to "Linking Your Session" below.

1

Open the Disk Image

Double-click the downloaded .dmg file. A window appears — drag TTFDesk into the Applications folder.

2

First Launch (Gatekeeper)

Because TTFDesk is distributed outside the Mac App Store, macOS will block it on first launch. In Finder, right-click TTFDesk → Open → Open again in the dialog. You only need to do this once.

3

Grant Screen Recording Permission

Go to System Settings → Privacy & Security → Screen Recording. Toggle TTFDesk on. You will be prompted to quit and relaunch — do so.

4

Grant Accessibility Permission

Go to System Settings → Privacy & Security → Accessibility. Toggle TTFDesk on. This allows the expert to control your mouse and keyboard.

5

You're Ready

TTFDesk appears in your Dock and menu bar. Proceed to "Linking Your Session" below.

⚠️ macOS requires Python 3 for mouse/keyboard injection. It is pre-installed on macOS 12.3+. On older macOS, install via brew install python3.

1

Install xdotool (one-time)

TTFDesk uses xdotool to inject mouse and keyboard events on Linux. Install it with:
sudo apt install xdotool (Debian/Ubuntu/Mint)
sudo dnf install xdotool (Fedora/RHEL)
sudo pacman -S xdotool (Arch)

2

Make AppImage Executable

Open a terminal in the download folder and run:
chmod +x TTFDesk-1.0.0-linux-x64.AppImage

3

Run TTFDesk

Double-click the AppImage in your file manager, or from terminal:
./TTFDesk-1.0.0-linux-x64.AppImage

4

FUSE Note (Ubuntu 22.04+)

If you see a FUSE error, install the compatibility package:
sudo apt install libfuse2

How to Use TTFDesk in a Support Session

1

Start a support chat

Open the TouchToFix mobile app → My Tickets → chat with your assigned expert.

2

Expert requests remote control

Your expert taps "Request Remote Session" in the chat. You will receive a message containing a Transfer Token and a 6-digit OTP.

3

Open TTFDesk and pick your screen

Launch TTFDesk on your PC. In Step 1, click the thumbnail of the screen or window you want to share.

4

Paste the token and OTP

In Step 2, paste the Transfer Token and the 6-digit OTP from the chat message, then click Link Session.

5

Start sharing

Click ▶ Start Sharing. Your expert's FixMe Portal will show your screen live.

6

Allow remote control (optional)

If you want your expert to control the mouse and keyboard, toggle Allow Remote Control. You can revoke this at any time by toggling it off.

7

End the session

Click ✕ End Session when you're done. TTFDesk minimises to the system tray — right-click the tray icon → Quit to exit completely.

✅ Privacy first: Remote control is OFF by default. Your expert can only view your screen unless you explicitly toggle it on. The session ends the moment you click End Session or close TTFDesk.

Expert: Viewing & Controlling via FixMe Portal

1

Open FixMe Portal

Go to fixme.touchtofix.com in any desktop browser (Chrome, Firefox, Edge, Safari).

2

Select Expert tab & enter token

Click the 🎧 Expert tab. Paste the Transfer Token (from the session you created in the mobile app) and the OTP, then click Connect as Viewer.

3

Wait for customer to start sharing

Once the customer clicks Start Sharing in TTFDesk, their screen appears in your browser.

4

Point, click and type

Move your mouse over the customer's screen in the browser. Your cursor appears on their screen. Clicking or typing (when customer has enabled control) injects real input on their machine.

System Requirements

Platform	Minimum	Notes
Windows	Windows 10 64-bit	Run as Administrator for input control
macOS	macOS 11 Big Sur	Screen Recording + Accessibility permissions required; Python 3 must be available
Linux	Ubuntu 20.04 / equivalent	X11 session; xdotool installed; libfuse2 on Ubuntu 22.04+
RAM	4 GB	8 GB recommended for smooth screen sharing
Network	2 Mbps upload	5 Mbps+ for HD quality; firewall must allow outbound HTTPS (443) and WSS

Troubleshooting & FAQ

The expert sees a black screen after I start sharing.▼

This is usually a WebRTC connectivity issue. Try: (1) Check your firewall allows outbound connections on port 443. (2) Refresh the FixMe portal page and reconnect. (3) If behind a corporate firewall or VPN, ask IT to allow WebRTC traffic. The updated FixMe portal (v1.0+) includes an ICE candidate buffering fix for most black-screen cases.

macOS: TTFDesk won't open — "Apple cannot verify this app"▼

TTFDesk is not yet notarised with Apple. Right-click the app in Finder → Open → Open. This adds a security exception. Alternatively: System Settings → Privacy & Security → scroll down → click "Open Anyway" next to TTFDesk.

macOS: Mouse/keyboard control isn't working.▼

Go to System Settings → Privacy & Security → Accessibility and ensure TTFDesk is toggled ON. Also confirm Python 3 is installed: open Terminal and run python3 --version. If not found, run brew install python3.

Linux: Mouse/keyboard control isn't working.▼

Install xdotool: sudo apt install xdotool then restart TTFDesk. Ensure you're using an X11 session (not Wayland). On Ubuntu, at the login screen click the gear icon and select "Ubuntu on Xorg".

Linux AppImage won't start — "FUSE" error▼

On Ubuntu 22.04+, FUSE 2 is not installed by default. Run: sudo apt install libfuse2 then try again.

Windows: "The token is invalid or expired"▼

Transfer tokens expire after 30 minutes and can only be used once. Ask your expert to generate a new token from the mobile app chat. Copy it carefully — do not include any spaces.

Can the expert access my PC without me knowing?▼

No. A session requires: (1) a Transfer Token you receive in your chat, (2) a 6-digit OTP, and (3) you clicking "Link Session" and "Start Sharing" in TTFDesk. Remote control is an additional step that you control with a toggle. There is no background access — TTFDesk does nothing until you link it to a session.

How do I update TTFDesk to a newer version?▼

Download the new installer from this page. On Windows, run the new installer — it will update in place. On macOS, drag the new version to Applications (it will replace the old one). On Linux, just replace the AppImage file.