streaming_slimjet_v49.0.2 Files

PLEASE NOTE:-
--------------------


The *recommended* location for this portable application is in /mnt/home. 
If you place your portable in /mnt/home, when adding the MenuEntry it will 
sym-link the 'LAUNCH' script into /usr/bin, place a .desktop entry in 
/usr/share/applications, and an icon in /usr/share/pixmaps. It will then
 restart "X", in order that the MenuEntry will show up in the Menu.

It should launch without issue.

However; IF you wish to place the portable application in a different 
location, that's not a problem. First, use the 'Menu-Remove' script to 
remove the existing MenuEntry. Let the desktop settle after "X" has restarted,
 then move the portable to the desired location. Finally, re-add the MenuEntry
  with the 'Menu-Add' script.

The MenuEntry removal/re-adding steps are necessary because Linux does
 not, under normal circumstances, permit the migrating of links from one location/file-system to another. 'Soft' links will lose their 'target', and hard links can no longer locate the specified inode. Therefore, the MenuEntry needs to be re-created from its new location.

None of these steps take long to perform, and add another layer of 
convenience, since with a .desktop file you can also add the application to
 the QuickLaunch area of the tray, etc.
 
 FULL EXPLANATION:

#  README — Portable Slimjet Launcher (RUN-turbo-STREAMING)

## Portable Execution — Run From Any Folder

This launcher is designed to be **fully portable by folder**.

It will work correctly **from any location** where you place the Slimjet portable directory, including:

* Internal drives (SSD / HDD)
* External drives (USB)
* Network mounts
* Different partitions
* Any user directory

You **do not need to modify the script** when moving the folder.

---

## How It Works

The launcher automatically detects its own location using:

```sh
HERE="$(dirname "$(readlink -f "$0")")"
```

This means:

* The script finds the **real folder where it is located**
* All paths are built **relative to that folder**
* The launcher does **not depend on the current working directory**

You can run it:

* From a terminal
* From a desktop launcher
* From a different directory
* Through a symbolic link

And it will still work correctly.

---

## Required Folder Structure

For proper operation, the **internal structure must be preserved**.

Example:

```
Slimjet-Portable/
│
├── slimjet/
│   └── flashpeak-slimjet
│
├── spot/
│   └── PROFILE/
│
├── DATA/
│   └── spot.txt   (optional)
│
├── slimjet-launcher.sh
│
└── README.md
```

Important:

* You must move **the entire folder**
* Do not move only the launcher file
* Do not rename internal folders unless paths are updated

---

## Portable Behavior

This launcher supports:

✔ Running from any folder
✔ Running from USB devices
✔ Running from RAM-based systems (EasyOS friendly)
✔ Symbolic links
✔ Desktop launchers
✔ Multiple copies in different locations

Each copy maintains:

* Its own profile
* Its own cache
* Its own configuration

No system installation required.

---

## Spot Mode Support (Optional)

If the file exists:

```
DATA/spot.txt
```

and the system supports:

```
run-as-spot
```

then Slimjet will automatically run as **spot user**.

Otherwise:

It runs as **root**.

No configuration changes required.

---

## Cache and Performance Behavior

Temporary cache is stored in:

```
/tmp/slimjet-cache
```

Benefits:

* Faster performance
* Reduced disk writes
* Ideal for RAM-based systems
* Better SSD longevity

---

## Compatibility Notes

This launcher requires:

* `readlink` with `-f` support
* A standard Linux environment
* Slimjet binary present in:

```
slimjet/flashpeak-slimjet
```

Compatible with:

* EasyOS
* Puppy Linux
* Devuan
* Debian-based systems
* Most modern Linux distributions

---

## Design Philosophy

**pp4mnk style**

Minimal · Fast · Functional

Designed for:

* Maximum portability
* Minimal CPU usage
* Fast streaming
* RAM-based Linux systems
* Long hardware lifespan

---

## Summary

✔ Works from **any folder**
✔ Requires **no installation**
✔ Fully **portable by directory**
✔ Safe to move between drives
✔ Ideal for EasyOS portable workflows