https://github.com/equiel-1703/ps2-network-manager
A GUI Python app to manage a SAMBA server for communication with a PlayStation 2 via SMB.
https://github.com/equiel-1703/ps2-network-manager
openps2loader pyqt6 python3
Last synced: 12 months ago
JSON representation
A GUI Python app to manage a SAMBA server for communication with a PlayStation 2 via SMB.
- Host: GitHub
- URL: https://github.com/equiel-1703/ps2-network-manager
- Owner: Equiel-1703
- License: mit
- Created: 2025-02-25T00:43:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T18:18:44.000Z (about 1 year ago)
- Last Synced: 2025-03-22T19:23:35.487Z (about 1 year ago)
- Topics: openps2loader, pyqt6, python3
- Language: Python
- Homepage:
- Size: 437 KB
- Stars: 75
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PS2 Network Manager
PS2 Network Manager is a tool designed to manage and configure a [Samba](https://www.samba.org/) server for sharing files with a PlayStation 2 console via the SMB protocol on [OPL](https://www.ps2homebrew.org/Open-PS2-Loader/). It provides a graphical user interface (GUI) to simplify the setup and management of network shares, IPs, and other Samba settings.
This project is a collaborative effort by Henrique Rodrigues, Daniel Lisboa, and Gabriel Pink, and is intended for educational purposes. We are not affiliated with or endorsed by any official PlayStation® or Sony® products.
## Features
- **NetBIOS Name Configuration**: Easily set and change the NetBIOS name of your Samba server.
- **PS2 Share Configuration**: Automatically create and manage the PS2 share folder with the correct access permissions.
- **Samba Configuration**: Automatically configure the Samba configuration file (`smb.conf`) to include the necessary settings for communicating with the PS2.
- **Network Interface Management**: Select and configure the network interface and IP address for the Samba server.
- **Server Control**: Start, stop, and monitor the Samba server status.
- **Network Speed Monitoring**: Real-time monitoring of upload and download speeds on the selected network interface.
## Installation
### Computer Prerequisites
- Linux operating system
- Python 3.6 or higher
- Samba installed on your system
### PS2 Prerequisites
- Modded to support OPL and others homebrew PS2 softwares. We used the ModBo 5.0 chip, but any other similar chip (like the Matrix Infinity) should work. [This](https://altarofgaming.com/playstation-2-modchips/) is a very good resource that explains about the varius modchips available.
- OPL software. We used OPL v1.1.0. Any version that supports SMB sharing should work just fine. Check the latest OPL build in their repo [here](https://github.com/ps2homebrew/Open-PS2-Loader).
### Installation Steps
1. Clone the repository:
```sh
git clone https://github.com/Equiel-1703/ps2-network-manager.git
cd ps2-network-manager
```
2. Make sure you are in a Python 3 virtual environment. If you don't have one, create it and activate it:
```sh
python3 -m venv myenv
source myenv/bin/activate
```
3. Install all the required Python packages in your virtual environment:
```sh
pip install -r requirements.txt
```
4. Ensure you have the necessary permissions to run the script:
```sh
sudo chmod +x "PS2 Network Manager.py"
```
5. Done! You can now run the script.
## Usage
1. Ensure you are in sudo mode or have root privileges. The app needs these permisions to manipulate the Samba configuration file in `/etc/Samba/smb.conf`:
```sh
sudo su
```
2. Ensure you are in the Python 3 virtual environment where you installed the requirements earlier. If you are not, activate it:
```sh
source myenv/bin/activate
```
3. Run the script:
```sh
python3 "PS2 Network Manager.py"
```
4. Enjoy!
## Debug Mode
To run the script in debug mode, use the `-d` or `--debug` flag:
```sh
python3 "PS2 Network Manager.py" --debug
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Authors
- [Henrique Rodrigues](https://github.com/Equiel-1703)
- [Daniel Lisboa](https://github.com/danlisb)
- [Gabriel Pink](https://github.com/GabrielRosaO)
## Acknowledgements
- Special thanks to [PS2 Homebrew](https://www.ps2homebrew.org/) for their amazing work on the [Open PS2 Loader](https://github.com/ps2homebrew/Open-PS2-Loader).
- Many thanks to the Samba team for their great work with the [Samba](https://gitlab.com/samba-team/samba) tool.