From 4a45fe0ee7ab930f4a2a9e37e644983574df15a3 Mon Sep 17 00:00:00 2001
From: Whisker Jones <medusa@aphrodite.atlantis.lan>
Date: Tue, 28 May 2024 17:01:15 -0600
Subject: [PATCH] add xdg-open document

---
 tech_docs/xdg-open.md | 86 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 tech_docs/xdg-open.md

diff --git a/tech_docs/xdg-open.md b/tech_docs/xdg-open.md
new file mode 100644
index 0000000..2dd90ed
--- /dev/null
+++ b/tech_docs/xdg-open.md
@@ -0,0 +1,86 @@
+Certainly! Here's a comprehensive user guide for xdg-open, including its advanced features:
+
+## xdg-open User Guide
+
+`xdg-open` is a command-line utility that opens a file or URL using the default application associated with the file type or URL scheme. It is part of the xdg-utils package and follows the XDG (X Desktop Group) standards for interoperability between applications on Unix-like systems.
+
+### Basic Usage
+
+To open a file or URL using xdg-open, simply provide the file path or URL as the argument:
+
+```
+xdg-open [file|URL]
+```
+
+Examples:
+- Open a file: `xdg-open example.txt`
+- Open a URL: `xdg-open https://www.example.com`
+
+### Opening Specific File Types
+
+`xdg-open` automatically determines the default application to open a file based on its MIME type. It uses the `mime.types` and `mimeapps.list` files to make this association.
+
+Examples:
+- Open an image: `xdg-open image.jpg`
+- Open a PDF: `xdg-open document.pdf`
+- Open an HTML file: `xdg-open index.html`
+
+### URL Handling
+
+`xdg-open` can open URLs using the default web browser. It supports various URL schemes such as `http`, `https`, `ftp`, `file`, and more.
+
+Examples:
+- Open a website: `xdg-open https://www.example.com`
+- Open an FTP URL: `xdg-open ftp://ftp.example.com`
+- Open a local file URL: `xdg-open file:///path/to/file`
+
+### Advanced Features
+
+1. **Specifying an Application:**
+   You can override the default application and specify a specific application to open a file or URL using the `--app` option followed by the application's desktop file name.
+
+   Example:
+   - Open a text file with a specific text editor: `xdg-open --app=org.gnome.gedit example.txt`
+
+2. **Opening in a New Window:**
+   By default, `xdg-open` opens files and URLs in the existing window of the default application. To force opening in a new window, use the `--new-window` option.
+
+   Example:
+   - Open a file in a new window: `xdg-open --new-window example.txt`
+
+3. **Printing Files:**
+   `xdg-open` can be used to print files directly using the default print command. Use the `--print` option to print the specified file.
+
+   Example:
+   - Print a file: `xdg-open --print document.pdf`
+
+4. **Selecting a Specific Screen:**
+   In multi-monitor setups, you can specify the screen where the application should open using the `--screen` option followed by the screen number (starting from 0).
+
+   Example:
+   - Open a file on the second screen: `xdg-open --screen 1 example.txt`
+
+5. **Debugging and Verbose Output:**
+   To troubleshoot issues or get more detailed information about the execution of `xdg-open`, you can use the `--verbose` option to enable verbose output.
+
+   Example:
+   - Open a file with verbose output: `xdg-open --verbose example.txt`
+
+### Configuration
+
+The behavior of `xdg-open` can be customized through configuration files. The main configuration files are:
+
+- `~/.config/mimeapps.list`: User-specific associations between MIME types and applications.
+- `/etc/xdg/mimeapps.list`: System-wide associations between MIME types and applications.
+
+You can modify these files to change the default applications for specific file types or URL schemes.
+
+### Conclusion
+
+`xdg-open` is a versatile command-line utility that simplifies opening files and URLs using the default applications on Unix-like systems. It provides a consistent and convenient way to launch applications and handle different file types and URL schemes.
+
+By leveraging the advanced features of `xdg-open`, you can customize its behavior, specify alternative applications, open files in new windows, print files directly, and more. The configuration files allow you to fine-tune the associations between file types and applications.
+
+Remember to use the `--verbose` option when debugging or troubleshooting issues with `xdg-open`. It provides detailed output that can help identify any problems or misconfigurations.
+
+With `xdg-open`, you can easily integrate file and URL opening capabilities into your scripts and command-line workflows, enhancing your productivity and efficiency on Unix-like systems.