# Gritseek Desktop Installation Guide

**Version 2.0** | **Gritseek Ventures Ltd** | **CH 14792628**

---

## Overview

The Gritseek Desktop App provides one-click access to all 15+ platform services from your desktop. Built with PyWebView for a native experience on Windows, macOS, and Linux.

## Download

- **Download URL**: [workstation.gritseek.com/COCOON-FIN-Desktop-v2.0.zip](https://workstation.gritseek.com/COCOON-FIN-Desktop-v2.0.zip)
- **Package size**: ~15KB (lightweight launcher)
- **Requirements**: Python 3.8+, pip

---

## Installation — Windows

```powershell
# 1. Download and extract
Invoke-WebRequest -Uri "https://workstation.gritseek.com/COCOON-FIN-Desktop-v2.0.zip" -OutFile "COCOON-FIN-Desktop-v2.0.zip"
Expand-Archive -Path "COCOON-FIN-Desktop-v2.0.zip" -DestinationPath "COCOON-FIN-Desktop"

# 2. Install dependencies
cd COCOON-FIN-Desktop
pip install -r requirements.txt

# 3. Run
python main.py
```

Or use the build script for a standalone `.exe`:

```powershell
build.bat
# Output: dist/COCOON-FIN-Desktop.exe
```

## Installation — macOS

```bash
# 1. Download and extract
curl -L -o COCOON-FIN-Desktop-v2.0.zip https://workstation.gritseek.com/COCOON-FIN-Desktop-v2.0.zip
unzip COCOON-FIN-Desktop-v2.0.zip

# 2. Install dependencies
cd COCOON-FIN-Desktop
pip3 install -r requirements.txt

# 3. Run
python3 main.py
```

Or build a `.app` bundle:

```bash
chmod +x build.sh && ./build.sh
# Output: dist/COCOON-FIN-Desktop.app
```

## Installation — Linux

```bash
# 1. Download and extract
wget https://workstation.gritseek.com/COCOON-FIN-Desktop-v2.0.zip
unzip COCOON-FIN-Desktop-v2.0.zip

# 2. Install dependencies
cd COCOON-FIN-Desktop
sudo apt install -y python3-gi python3-gi-cairo gir1.2-webkit2-4.1  # GTK/WebKit
pip3 install -r requirements.txt

# 3. Run
python3 main.py
```

---

## Services Accessible

| # | Service | URL | Login Method |
|---|---------|-----|--------------|
| 1 | Workstation Dashboard | workstation.gritseek.com | Email + Password |
| 2 | COCOON.FIN Analytics | cocoonfin.gritseek.com | Username + Password |
| 3 | Odoo ERP | odoo.gritseek.com/web | Email + Password |
| 4 | Superset BI | superset.gritseek.com | Username + Password |
| 5 | JupyterHub | jupyter.gritseek.com | Lowercase username + Password |
| 6 | Mayan EDMS | mayan.gritseek.com | Username + Password |
| 7 | Grist | grist.gritseek.com | Email + Password |
| 8 | OnlyOffice | office.gritseek.com | Email + Password |
| 9 | Penpot Design | design.gritseek.com | Email + Password |
| 10 | Investor Portal | investor.gritseek.com | Username + Password |
| 11 | Client Portal | portal.gritseek.com | Username + Password |

## MetaTrader 5

MetaTrader 5 is a Windows-only binary. Download directly from [metatrader5.com](https://www.metatrader5.com/en/download).

---

## Troubleshooting

| Issue | Solution |
|-------|----------|
| Blank screen on launch | Check internet connection; ensure Python 3.8+ |
| PyWebView not found | `pip install pywebview` |
| GTK errors (Linux) | Install: `sudo apt install python3-gi gir1.2-webkit2-4.1` |
| SSL certificate errors | Update certificates: `pip install certifi` |
| Login fails | Verify credentials at workstation.gritseek.com first |

---

## Support

- **Admin**: pedro.gameiro@gritseek.com
- **Workstation**: [workstation.gritseek.com](https://workstation.gritseek.com)
- **Registration**: [workstation.gritseek.com/register.html](https://workstation.gritseek.com/register.html) (invite token required)

---

*Created using COCOON.FIN, a product by Gritseek\u00ae*
*Gritseek Ventures Ltd \u2022 71-75 Shelton Street, Covent Garden, London WC2H 9JQ \u2022 CH 14792628*