Difference between revisions of "CiTRUS"

From 3dbrew
Jump to navigation Jump to search
 
(17 intermediate revisions by 3 users not shown)
Line 8: Line 8:
 
}}
 
}}
  
Over the past weeks I have been working on Project CiTRUS (citrus). Currently this tool boasts the capability to output "proper" Nintendo 3DS (CTR) BaNneR and ICoN files using my XBSF format.
+
= '''IMPORTANT''' =
 +
The CXI generator has not been released yet, please understand it is under development. I apologize for adding in the possibility of using retail RSA keys; they would be so hard for us to get it wouldn't even be funny having them. However, when homebrew is available to this community the output should be usable, as a homebrew loader would not check the signature.
 +
 
 +
= Notes from users =
 +
<del>This application may not generate completely perfect files yet.</del>
 +
Banner output has been checked. It is proper data if the program is used properly. The same goes for the ICN.
 +
 
 +
= General information =
 +
== Introduction ==
 +
Over the past weeks I have been working on Project CiTRUS (citrus). Currently this tool boasts the capability to output proper Nintendo 3DS (CTR) BaNneR and ICoN files using my XBSF format.
  
  
Line 25: Line 34:
  
 
----
 
----
 
  
 
== USE ==
 
== USE ==
  
Since v0.2, a readme is not really necessary anymore. I've included helpful text inside each tab in the CiTRUS window to do things on-the-fly without needing to switch between notepad and CiTRUS.
+
Since v0.2, a readme is not really necessary anymore. I've included helpful text inside each tab in the CiTRUS window to do things on-the-fly without needing to switch between notepad (or your favourite text editor) and CiTRUS.
  
 
INPUT:
 
INPUT:
Line 49: Line 57:
 
==UPCOMING==
 
==UPCOMING==
  
3/1/2012 @ 17:02 PST
+
5/7/2012
 
 
I am proud to reveal what this upcoming project is today.
 
 
 
 
 
It has come to my attention that there is no GBATemp Homebrew Bounty. At the time of writing the news above (~3 weeks ago) I was under the impression it would happen again.
 
 
 
 
 
Regardless by saying "at" I was implying "by". I will still release this next version, to be dubbed "CiTRUS Ultimate". Currently I do not have an estimate of when the release will be exactly, but I am hoping for sometime next week since I am getting positive results.
 
 
 
 
 
I know, due to the nature of how I am "unknown" to the scene, I may be considered a liar or fraud. To assure you that I am honest with my work I will enclose a download to a work-in-progress 3DS-mode Homebrew ("Hello World") CXI I developed using CiTRUS Ultimate.
 
 
 
 
 
http://www.mediafire.com/?lnc2o6372iq98cl
 
 
 
 
 
I understand some of the misinformed users of gbatemp may think this is developer-only but in fact it can be retail signed, provided the right RSA keys. In my demo, I used a fake RSA key. When using this program, I provide you an option to specify your own RSA keys for signing. No illegal keys will be provided. The CXI is a format used by both retail and developer 3DS's, not just developer!
 
  
  
Please note that this CXI has not been tested for loading but it has valid structure, a valid ExeFS (contains ARM11 code, banner, icon, and logo) and has been accepted in transformations to other formats. To the best of my knowledge this is very close to a proper CXI, if not a proper one already.
+
Well, it's been a fun 7 months so far.
  
  
In the initial release of this new feature in CiTRUS I will only include very simple options, but if I see users are enjoying this program I will add more to it.
+
Encrypted, proper CXI:
  
  
In case some of you wonder, this does not have a RomFS. I admit I have not delved into that yet.
+
http://www.mediafire.com/?hcm1p6fq4x7q14o
  
  
Currently this has the capability to enable debug modes, sign[-], hash, and create CXI files out of an ELF/AXF to the best of my knowledge.
+
Signatures, Hashes, ExeFS, Extended Header, Flags[-], NCCH header, and encryption are now valid. The only thing left now is the RomFS.
  
  
[-] = RSA key is required for retail/developer signatures.
+
[-] = It seems flags for developer applications may differ from retail application flags, but it is not a big deal as when retail applications can be decrypted I can replace and change my flags to fit retail needs. The generated CXIs would still require an exploit to run on a retail 3DS, however.
 +
The flags are already laid out and are valid developer flags, though.
  
 
==UPDATES==
 
==UPDATES==

Latest revision as of 18:37, 7 May 2012

CiTRUS
General
Author(s)Xcution
TypePC utility
Version0.2
Links
Download


IMPORTANT[edit]

The CXI generator has not been released yet, please understand it is under development. I apologize for adding in the possibility of using retail RSA keys; they would be so hard for us to get it wouldn't even be funny having them. However, when homebrew is available to this community the output should be usable, as a homebrew loader would not check the signature.

Notes from users[edit]

This application may not generate completely perfect files yet. Banner output has been checked. It is proper data if the program is used properly. The same goes for the ICN.

General information[edit]

Introduction[edit]

Over the past weeks I have been working on Project CiTRUS (citrus). Currently this tool boasts the capability to output proper Nintendo 3DS (CTR) BaNneR and ICoN files using my XBSF format.


You may notice that creating these formats is not yet available in any other released tool. Over the course of time I will do my best to add creating new formats of 3DS files among various other calculations if I see users are liking the program.



If you have v0.1 please update it! There are new bug fixes, GUI changes, and updates! It is also more n00b compliant than the previous version. (now has a lot of help text)


I do not include an editor for the image formats, however, I do include an example of each required file for generating a test banner/icon. I do this not to troll, but rather in the hopes that it will encourage other talented users to make programs for the 3DS.



USE[edit]

Since v0.2, a readme is not really necessary anymore. I've included helpful text inside each tab in the CiTRUS window to do things on-the-fly without needing to switch between notepad (or your favourite text editor) and CiTRUS.

INPUT:

  • 1x XBSF (Xtended Banner Specifications(Spec) File)
  • 2x CTPK (CTR Texture PacKage)
  • 1x BCWAV (Banner CTR Wave)
  • 1x CBMD (CTR Banner Model Data)

OUTPUT:

  • 1x BNR (Optional)
  • 1x ICN (Optional)

ISSUES[edit]

I don't think there is any, but since this is a beta please report to me if there are issues that come about!

UPCOMING[edit]

5/7/2012


Well, it's been a fun 7 months so far.


Encrypted, proper CXI:


http://www.mediafire.com/?hcm1p6fq4x7q14o


Signatures, Hashes, ExeFS, Extended Header, Flags[-], NCCH header, and encryption are now valid. The only thing left now is the RomFS.


[-] = It seems flags for developer applications may differ from retail application flags, but it is not a big deal as when retail applications can be decrypted I can replace and change my flags to fit retail needs. The generated CXIs would still require an exploit to run on a retail 3DS, however. The flags are already laid out and are valid developer flags, though.

UPDATES[edit]

Version 0.2:

  • Fix: "Polish" changed "Portuguese"
  • Fix: Can now Set region to Taiwan
  • Fix: Can now Set rating to true
  • Add: Colour scheme of menu items to match colour scheme menu bar
  • Add: ComboBox for regions and ratings
  • Add: Checkboxes instead of true/false typing
  • Add: Automatic saving before building
  • Add: Banner writing progress bar/notification of finishing
  • Add: Help box incorporated into each tab (except title name/publisher tabs because those are not so complicated)
  • Add: Name now reflects what's on here (CiTRUS) and version number (v0.2)

MEDIA[edit]

CiTRUS v0.1.png