From d3127d400406ff48fde11cae862830102ba2e96a Mon Sep 17 00:00:00 2001 From: Riuga Date: Wed, 1 Apr 2026 10:27:18 -0500 Subject: [PATCH] Update readme --- README.md | 11 +++-------- 1 file changed, 3 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index e4bdf51..05e1cd1 100644 --- a/README.md +++ b/README.md @@ -2,21 +2,16 @@ DTCC onboarding process requires you to access a remote Windows desktop via Citrix Workspace. -The Citrix package is a bit finnicky to install and is closed-source and considered insecure for our requirements here at Obsidian. This flake 1) wraps the `citrix_workspace` package with a scraper that automatically downloads the tarball for you, and 2) provides Citrix-in-a-NixOS-Qemu-VM with a convenient init script that copies in your preferred .ica file to launch it with. +The Citrix package is a bit finnicky to install and is closed-source and considered insecure for our requirements here at Obsidian. This flake 1) wraps the `citrix_workspace` package with a scraper that automatically downloads the tarball for you, and 2) provides Citrix-in-a-NixOS-Qemu-VM with a convenient init script that optionally copies in your preferred .ica file to launch it with. If you choose not to select a .ica file, it will just start an `ungoogled-chromium` browser session pointed at `https://myvdi.dtcc.com` where you can log in, download the .ica manually and chromium will be configured to automatically launch it with Citrix `wfica` on download completion. -The init script looks for ICA files in your XDG download dir (`~/Downloads`) and current working dir (i.e. the repo root). +The init script looks for ICA files in your XDG download dir (`~/Downloads`) and current working dir (i.e. the repo root). Again, this is not required if you just want a browser-based session within the VM instead. **Usage of this repository implies you have read and accepted the Citrix EULA found here**: https://www.cloud.com/content/dam/cloud/documents/legal/end-user-agreement.pdf -Notes/future improvements: -- There is still the manual step of logging into myvdi.dtcc.com to download a fresh ICA file each connection attempt. We could look into automating this in the future; it's a bit more involved though. -- We should provide a containerized flake output as well. I don't see why this wouldn't work as a container; the VM feels a bit like bringing a tank to a knife fight. I just needed to get a simple -working demo out before the next wave of onboarding begins and this had the best shot at providing the most stable user experience. - --- Usage: ```bash -# Prompt for ICA file selection and launch the VM. +# Prompt for ICA file selection (can leave blank) and launch the VM. nix run ```