Zeebo Utils

O Zeebo Utils (ou ZeeUtils) é uma ferramenta que adiciona algumas funcionalidades úteis ao Zeebo, como obter dados mais detalhados do sistema e alterar configurações não disponíveis por meios normais.

Funcionalidades & Changelog

O ZeeUtils é capaz de:

v1.0.0
- Nova versão com UI baseada no ImGui e totalmente renderizada via OpenGL ES
- Escolha do aplicativo inicial e sistema de cores do console
- Alterar configurações da Z-Wheel instalada
- Limpar arquivos desnecessários
- Suporte inicial aos recursos de backup e restauração do console para uma mídia externa (SD ou USB)
- Suporte a pendrive USB para os mecanismos de cópia e restauração de dados (mais lento que o cartão SD, no entanto)
- Apagar BLFs (BREW License File) (pode ser útil para consoles que não executam algum jogo mesmo com o desbloqueio).
- Reset - permite reiniciar o console sem precisar “tirar e colocar da tomada”.

v0.2.1 Alpha
- Verificar e opção de remover o arquivo zmcp.dat da raiz da NAND;
- Trocar o sistema de cores do console, entre PAL-M ou NTSC;

v0.2 Alpha
- Mostrar informações de memória RAM (heap) disponível;
- Mostrar informações sobre o sistema de arquivos (livre e total, NAND e eNAND);
- Copiar o arquivo hid_devices.cfg de um cartão SD para a memória interna;
  - Permite adicionar suporte a novos joysticks no console
- Copiar o arquivo Flixfile.dat de um cartão SD para a memória interna;
  - Permite trocar o aplicativo inicial do console (Z-Wheel ou Appmgr)
- Executar o BREW Appmgr diretamente da Z-Wheel;

Novas funcionalidades serão adicionadas futuramente.

Instalação

É necessário um console desbloqueado para instalar e usar este utilitário.

Do ZeeUtils

O processo é o mesmo utilizado em quaisquer jogos para o console.

Obtenha a última versão na área de Downloads (zeeutils-v*.zip).
Extraia o conteúdo do ZIP para a raiz de um cartão SD. Após a extração, você verá 2 pastas no SD: mif e mod.
Insira o cartão no Zeebo, abra o EMAPPLET, vá em “Field Test” e execute o Memory Copy.
Após a cópia, reinicie o console.
Pronto! Ele estará disponível como “ZeeUtils” no Appmgr. É interessante (e importante) adicioná-lo na Z-Wheel também. Continue lendo.

Na Z-Wheel

Como a Z-Wheel mostra apenas os aplicativos que são configurados nela (não mostra os instalados no sistema), o ZeeUtils não aparecerá na lista de jogos. É importante que ele seja inserido na Z-Wheel ou configurado como o botão “Navegar”, assim é possível acessa-lo quando necessário e não perder acesso as outras áreas do console.

Caso 1

Se você já tem um console com todos os jogos, pode pegar a Z-Wheel completa e pronta na área de Downloads (274755-zeeutils.zip), extrair no SD e copiar da mesma forma que o ZeeUtils.

Pronto!

Lembrando que dentro da Z-Wheel também são armazenadas informações de idioma do console, quantas vezes já jogou cada jogo, etc., portanto se copiar esta, ficará tudo zerado de novo.

Caso 2

Caso seu console/Z-Wheel não tenha todos os jogos, é necessário editar sua cópia para inserir manualmente o ZeeUtils e assim não bagunçar os dados existentes:

Com a cópia de sua Z-Wheel no SD card, extraia o arquivo zeeutils-zwheel.zip (na área de Downloads) dentro da pasta 274755;
1. Assim será adicionado os dados do ZeeUtils dentro da pasta “assets”
Ainda na pasta 274755, abra o banco de dados “tt_game_info” de sua Z-Wheel em algum editor para db SQLite (este, por exemplo https://sqlitebrowser.org/ );

Execute o seguinte SQL:

INSERT INTO GAMEINFO VALUES (30000000, 16818170, 0, 0, 0, './assets/games/30000000/', 0, 512000);
INSERT INTO TITLETEXT VALUES (30000000, 538996325, 'Zeebo Utils');
INSERT INTO TITLETEXT VALUES (30000000, 538997605, 'Zeebo Utils');
INSERT INTO TITLETEXT VALUES (30000000, 538997872, 'Zeebo Utils');

Salve e copie de volta para seu console através do Memory Copy.
Pronto!

Uso

No momento, os recursos disponíveis são autoexplicativos no próprio ZeeUtils. Pressione L3 dentro do aplicativo para mostrar a ajuda.

Por enquanto somente versões de único idioma do ZeeUtils estão disponível, logo terão suporte a inglês e português.

Downloads

As versões com -log no nome do arquivo criam um arquivo de log na raiz do cartão SD (zeeutils.log) para fins de diagnóstico. Ou seja, elas não funcionam sem um cartão.

Caso não tenha sido instruído a usar esta versão, utilize os que não possuem -log no nome.

ZeeUtils

Adicionais

FAQ

O que é e o que significa a presença ou não do “zmcp.dat”?

O console tem um componente chamado ZeeboMCP, que é utilizado pela Z-Wheel ao rodar um jogo. Este componente é o responsável por copiar o jogo solicitado para a NAND antes de roda-lo (por isso demora tanto começar um jogo pela Z-Wheel). O arquivo “zmcp.dat” é que guarda o status de qual jogo está na NAND.

Normalmente, este arquivo só deve estar presente enquanto o jogo está rodando e foi lançado pela Z-Wheel. Se rodar o ZeeUtils pelo Appmgr e ele estiver lá, pode significar que algum jogo “vazou” para a NAND ou a Z-Wheel está aguardando execução para limpa-lo.

Licenças

ImGui

The MIT License (MIT)

Copyright (c) 2014-2023 Omar Cornut

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

Fonte Proggy Vector

MIT LICENSE

Copyright (c) 2019 Tristan Grimmer
Copyright (c) 2018 Source Foundry Authors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.