Skip to content

Commit d3402cf

Browse files
committed
feat: Adiciona documentação inicial, metadados da aplicação e atualiza informações de versão e licença.
1 parent ca7ba62 commit d3402cf

File tree

6 files changed

+105
-3
lines changed

6 files changed

+105
-3
lines changed

README.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# ZSO Converter
2+
3+
A modern and lightweight application to compress and decompress PS2 games in **ZSO** (ZISO) format, built with **GTK 4** and **LibAdwaita**.
4+
5+
![Icon](data/icon.svg)
6+
7+
## ✨ Features
8+
9+
- **Native and Modern**: Visuals following GNOME standards (Adwaita).
10+
- **Easy to Use**: Drag and drop files or entire folders.
11+
- **Multiprocessing**: Accelerated compression using all processor cores.
12+
- **Secure**: Sandboxed execution via Flatpak, using XDG Portals.
13+
- **Hybrid**: Works via both graphical interface or command line.
14+
15+
## 🚀 How to Use
16+
17+
### Prerequisites
18+
- Linux with [Flatpak](https://flatpak.org/) support.
19+
- `flatpak-builder` (to compile).
20+
21+
### Installation and Execution
22+
```bash
23+
# 1. Compile and install (User mode)
24+
make
25+
26+
# 2. Run
27+
make run
28+
29+
# 3. Clean build files
30+
make clean
31+
```
32+
33+
> **Note**: When running, select the destination folder for conversion. The app will automatically filter duplicate or invalid files.
34+
35+
## 🛠️ Technologies
36+
37+
- **Python 3**
38+
- **GTK 4** + **LibAdwaita**
39+
- **LZ4** (Compression)
40+
41+
## 📜 Credits
42+
43+
- Original Core: **Virtuous Flame**
44+
- Development: **Gabriel**

data/org.ziso.gui.metainfo.xml

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<component type="desktop-application">
3+
<id>org.ziso.gui</id>
4+
<metadata_license>CC0-1.0</metadata_license>
5+
<project_license>GPL-2.0-or-later</project_license>
6+
<name>ZSO Converter</name>
7+
<summary>Compress and decompress PS2 ZSO images</summary>
8+
<description>
9+
<p>
10+
ZSO Converter is a modern, easy-to-use application for managing PlayStation 2 disc images.
11+
It allows you to compress standard ISO files into the ZSO format (ZISO) to save disk space
12+
while maintaining compatibility with loaders like OPL and PS2 emulators.
13+
</p>
14+
<p>Features:</p>
15+
<ul>
16+
<li>Modern GTK4 interface with LibAdwaita</li>
17+
<li>Multi-threaded compression</li>
18+
<li>Drag and drop support</li>
19+
<li>Native integration with Linux desktop</li>
20+
</ul>
21+
</description>
22+
<launchable type="desktop-id">org.ziso.gui.desktop</launchable>
23+
<developer_name>Virtuous Flame &amp; Gabriel</developer_name>
24+
<screenshots>
25+
<screenshot type="default">
26+
<image>data/screenshot.png</image>
27+
</screenshot>
28+
<screenshot>
29+
<image>data/screenshot1.png</image>
30+
</screenshot>
31+
</screenshots>
32+
<content_rating type="oars-1.1"/>
33+
</component>

data/screenshot.png

28.8 KB
Loading

data/screenshot1.png

44 KB
Loading

org.ziso.gui.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ modules:
2323
build-commands:
2424
- install -D src/ziso.py /app/bin/ziso
2525
- install -D data/org.ziso.gui.desktop /app/share/applications/org.ziso.gui.desktop
26+
- install -D data/org.ziso.gui.metainfo.xml /app/share/metainfo/org.ziso.gui.metainfo.xml
2627
- install -D data/icon.svg /app/share/icons/hicolor/scalable/apps/org.ziso.gui.svg
2728
- mkdir -p /app/share/locale/pt_BR/LC_MESSAGES
2829
- msgfmt po/pt_BR.po -o /app/share/locale/pt_BR/LC_MESSAGES/org.ziso.gui.mo

src/ziso.py

Lines changed: 27 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,30 @@
44
import threading
55
import locale
66

7+
# Copyright (c) 2011 by Virtuous Flame
8+
# Based BOOSTER 1.01 CSO Compressor
9+
# Adapted for codestation's ZSO format
10+
# GUI Implementation (GTK4) by Gabriel
11+
#
12+
# GNU General Public Licence (GPL)
13+
#
14+
# This program is free software; you can redistribute it and/or modify it under
15+
# the terms of the GNU General Public License as published by the Free Software
16+
# Foundation; either version 2 of the License, or (at your option) any later
17+
# version.
18+
# This program is distributed in the hope that it will be useful, but WITHOUT
19+
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
20+
# FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
21+
# details.
22+
# You should have received a copy of the GNU General Public License along with
23+
# this program; if not, write to the Free Software Foundation, Inc., 59 Temple
24+
# Place, Suite 330, Boston, MA 02111-1307 USA
25+
#
26+
27+
__author__ = "Virtuous Flame & Gabriel"
28+
__license__ = "GPL"
29+
__version__ = "1.0"
30+
731
import lz4.block
832
from struct import pack, unpack
933
from multiprocessing import Pool
@@ -60,7 +84,7 @@ def lz4_decompress(compressed, block_size):
6084

6185

6286
def usage():
63-
print("ziso-python 2.1 by Virtuous Flame (GUI Edition by Gabriel)")
87+
print("ziso-python (GTK4) 1.0 by Virtuous Flame & Gabriel")
6488
print("Usage: ziso [-c level] [-m] [-t percent] [-h] infile outfile")
6589
print(" -c level: 1-12 compress ISO to ZSO, 1 for standard compression, >1 for high compression")
6690
print(" 0 decompress ZSO to ISO")
@@ -637,7 +661,7 @@ def on_about(self, action, param):
637661
transient_for=win,
638662
application_name=_("ZSO Converter"),
639663
application_icon="org.ziso.gui",
640-
version="2.2",
664+
version="1.0",
641665
developer_name="Virtuous Flame & Gabriel",
642666
comments=_("Modern GTK4/Adwaita GUI for ZSO"),
643667
website="https://github.com/codestation/ziso"
@@ -701,7 +725,7 @@ def main():
701725
# CLI Mode
702726
level, bsize, fname_in, fname_out, mp, threshold, align, padding = parse_args()
703727

704-
print(f"ziso-python 2.1 (CLI)")
728+
print(f"ziso-python 1.0 (CLI)")
705729
if level == 0:
706730
print(f"Decompressing {fname_in} to {fname_out}...")
707731
decompress_zso(fname_in, fname_out)

0 commit comments

Comments
 (0)