Files
althea/README.md
T
powder 2699fcaebd Update README.md
Added un-maintained notice
2023-02-12 13:41:35 -05:00

193 lines
4.8 KiB
Markdown

# AltLinux
<img src="https://github.com/i-love-altlinux/AltLinux/blob/main/resources/4.png" alt="AltLinux Logo">
**UNMAINTAINED:**
Support for this version of AltLinux is no longer being provided in favour of AltLinuxV2. Please join our discord for updates regarding the revamp.
AltLinux is a GUI for AltServer-Linux that allows to easily sideload apps onto an iPhone, an iPad, or an iPod Touch. It supports iOS 12.2 and later.
Features:
- A straightforward GUI
- A tray menu that works just like on Windows
- Sideloading AltStore
- Sideloading apps without AltStore
- While the tray icon is present, AltServer runs in the background in tethered mode
- Launching the tray icon on start-up
The program is in its very early state, so if you're experiencing issues or want to help, you can join [the Discord server](https://discord.gg/vtvxYFAfAR).
## Install AltLinux
AltLinux is available for Ubuntu 22.04 and Ubuntu 20.04.
Derivatives, such as Linux Mint and Pop!_ OS should also work. To make sure which DEB package to pick, run the following command:
```
python3 --version
```
| Python 3.10 | Python 3.8 |
|:--------------------:|:-----------------:|
| Ubuntu 22.04 | Ubuntu 20.04 |
| Pop!_OS 22.04 | Pop!_OS 20.04 |
| Linux Mint 21 | Linux Mint 20 |
| elementary OS 7 | elementary OS 6 |
| Zorin OS 17 | Zorin OS 16 |
If you're running Ubuntu 22.04 or any distro based on it (such as Mint 21), install the DEB package [from here](https://github.com/i-love-altlinux/AltLinux/releases).
If you're running Ubuntu 20.04 or any distro based on it (such as Mint 20), run the following commands:
```
sudo add-apt-repository ppa:apandada1/libhandy-1
sudo apt update
sudo apt install libhandy-1-0 libhandy-1-dev
```
Then you can install the DEB package [from here](https://github.com/i-love-altlinux/AltLinux/releases).
If you use Arch Linux, you can use [the AUR package](https://aur.archlinux.org/packages/altlinux).
There is also a [git version](https://aur.archlinux.org/packages/altlinux-git) of AltLinux available as an AUR package.
If you use Fedora, you can [run the script without installing](#run-the-script-without-installing).
## Uninstall AltLinux
If you want to uninstall AltLinux, run the following commands:
```
sudo apt purge altlinux
```
```
sudo rm -rf /usr/lib/altlinux
```
```
rm -rf $HOME/.local/share/altlinux
```
## Run the script without installing
### Ubuntu:
Add the `universe` repository:
```
sudo add-apt-repository universe -y
```
Install the dependencies:
```
sudo apt-get install binutils python3-pip git gir1.2-appindicator3-0.1 usbmuxd libimobiledevice6 libimobiledevice-utils wget curl libavahi-compat-libdnssd-dev zlib1g-dev unzip usbutils
```
IF YOU'RE RUNNING UBUNTU 20.04 OR ITS [DERIVATIVES](https://github.com/i-love-altlinux/AltLinux#install-altlinux):
```
sudo add-apt-repository ppa:apandada1/libhandy-1
sudo apt update
sudo apt install libhandy-1-0 libhandy-1-dev
```
Run the following commands:
```
git clone https://github.com/i-love-altlinux/AltLinux
```
```
cd AltLinux
```
```
python3 main.py
```
### Fedora:
Install the dependencies:
```
sudo dnf install binutils python3-pip git libappindicator-gtk3 usbmuxd libimobiledevice-devel libimobiledevice-utils wget curl avahi-compat-libdns_sd-devel dnf-plugins-core unzip usbutils
```
Run the following commands:
```
git clone https://github.com/i-love-altlinux/AltLinux
```
```
cd AltLinux
```
```
python3 main.py
```
### Arch Linux
Install the dependencies:
```
sudo pacman -S binutils wget curl git python-pip libappindicator-gtk3 usbmuxd libimobiledevice avahi zlib unzip usbutils
```
Run the following commands:
```
git clone https://github.com/i-love-altlinux/AltLinux
```
```
cd AltLinux
```
```
python3 main.py
```
## Compile the DEB package
Add the `universe` repository:
```
sudo add-apt-repository universe -y
```
Install the dependencies:
```
sudo apt-get install binutils python3-pip git gir1.2-appindicator3-0.1 usbmuxd libimobiledevice6 libimobiledevice-utils wget curl libavahi-compat-libdnssd-dev zlib1g-dev unzip usbutils
```
If you're running Ubuntu 20.04 or any distro based on it (such as Mint 20), run the following commands:
```
sudo add-apt-repository ppa:apandada1/libhandy-1
sudo apt update
sudo apt install libhandy-1-0 libhandy-1-dev
```
Install pyinstaller:
```
pip3 install pyinstaller
```
Reboot your computer for changes to take effect.
After that, proceed by running the following commands:
```
git clone https://github.com/i-love-altlinux/AltLinux
```
```
cd AltLinux
```
```
./build.sh
```
The DEB file is ready! You can install it now.
## Credits
AltServer-Linux made by [NyaMisty](https://github.com/NyaMisty)
Artwork by [Nebula](https://github.com/itsnebulalol)
Provision by [Dadoum](https://github.com/Dadoum)