Troubleshooting: Installation & Build

Fix problems installing 1DevTool or launching it for the first time.

macOS: "Cannot Be Opened Because Developer Cannot Be Verified"

macOS blocks apps downloaded from outside the App Store by default. This is a Gatekeeper warning, not a sign that something is wrong with 1DevTool.

Fix using System Settings:

  1. Open System Settings → Privacy & Security
  2. Scroll down to the Security section
  3. You should see a message that says "1DevTool was blocked from use because it is not from an identified developer"
  4. Click Open Anyway
  5. Confirm in the dialog that appears

Alternative fix using Terminal:

bash
xattr -d com.apple.quarantine /Applications/1DevTool.app

Run this command once in Terminal, then launch 1DevTool normally. You will not be prompted again.

Windows: Antivirus Blocking Installation

Some antivirus programs flag new or unsigned installers as suspicious and block them during installation.

Fix:

  1. Temporarily disable real-time protection in your antivirus software.
  2. Run the 1DevTool installer.
  3. Re-enable real-time protection after installation completes.

To avoid disabling protection entirely, you can instead add an exception for the 1DevTool installer file (usually 1DevTool-Setup.exe) or for the installation directory (C:\Users\<you>\AppData\Local\1DevTool). The exact steps vary by antivirus — look for "Exclusions" or "Exceptions" in your antivirus settings.

Linux: AppImage Won't Launch

If double-clicking the AppImage does nothing, or it closes immediately, try these fixes in order:

Make the file executable. AppImages need execute permission before they can run:

bash
chmod +x 1DevTool-*.AppImage

Install FUSE. AppImages use FUSE (Filesystem in Userspace) to mount themselves. Many minimal Linux installs do not include it:

bash
sudo apt install libfuse2

On Fedora/RHEL: sudo dnf install fuse.

Run from Terminal to see error output. If it still fails, launch it from a terminal so you can read the error message:

bash
./1DevTool-*.AppImage --no-sandbox

The --no-sandbox flag is sometimes required in restricted environments like some corporate Linux setups or containers.

App Opens But Stays Blank

Symptom: 1DevTool launches and the window appears, but the interface never loads — just a white or gray blank screen.

Cause: corrupted app cache files from a previous installation or failed update.

Fix — delete the cache:

  • macOS:
    bash
    rm -rf ~/Library/Application\ Support/1DevTool/Cache
  • Windows: navigate to %APPDATA%\1DevTool\Cache in File Explorer and delete the Cache folder.
  • Linux: rm -rf ~/.config/1DevTool/Cache

After deleting the cache, restart 1DevTool. The cache rebuilds itself automatically.

tmux Not Found on Start

1DevTool uses tmux to keep terminal sessions alive when you switch panels or minimize the app. If tmux is not installed, you will see a warning on startup and terminals will not persist.

Install tmux:

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo yum install tmux or sudo dnf install tmux

After installing, quit 1DevTool completely and relaunch it. If you use a custom shell or a non-standard PATH, make sure the directory containing tmux (usually /usr/local/bin or /usr/bin) is included in your shell's PATH variable.