CIAngel 3DS: Difference between revisions

From GameBrew
No edit summary
No edit summary
Line 1: Line 1:
{{Obsolete}}
{{Infobox 3DS homebrew
{{Infobox 3DS homebrew
| title = CIAngel
| title = CIAngel
| image = https://dlhb.gamebrew.org/3dshomebrew/CIAngel.jpeg|250px
| image = https://dlhb.gamebrew.org/3dshomebrew/ciangle3ds01.png|250px
| type = Utilities
| type = Utilities
| version = v0.81
| version = 0.81 (12 May 2017)
| licence = Mixed
| licence = Mixed
| author = llakssz
| author = llakssz
Line 10: Line 12:
| source = https://dlhb.gamebrew.org/3dshomebrew/CIAngel-3DS.rar
| source = https://dlhb.gamebrew.org/3dshomebrew/CIAngel-3DS.rar
}}
}}
<youtube>uEYRu-n5pYE</youtube>


= CIAngel =
CIAngel is a homebrew program that can download CIAs directly on your 3DS. It is a fork of [https://github.com/machinamentum/FirmwareDownloader FirmwareDownloader] from machinamentum.
==== Archived, CDN access is not available anymore. RIP. ====
 
Now we can get games directly on the 3DS! Using a Title ID and an encrypted title key, or searching for a title by name, GOOD CIAs will be produced or directly installed that can be redownloaded from eshop and updated from eshop if new content comes out. These CIAs will not interfere with content from eshop. You can choose to create a CIA, install the game directly, or install only the ticket. Many thanks for machinamentum and FirmwareDownloader! Thanks to make_cdn_cia! License is GPL to comply with the usage of make_cdn_cia code. This will be improved, updated, I look forward to people contributing to this project!
'''Note:''' The project is obsoleted.
== Latest Version ==
 
You can scan the following QRCode in FBI to install the latest version of CIAngel, this will always point at the latest release's CIAngel.cia file: [[https://thedgtl.net/3ds/CIAngel.php?cachebust=2|CIAngel.cia]]
==User guide==
== Usage ==
Search by name:
=== Search by name ===
* CIAngel utilizes HBKBlib to search for titles by name. Data is read from /CIAngel/wings.json (Which is downloaded automatically on first launch) to search for the name entered.
CIAngel utilizes HBKBlib to search for titles by name. Data is read from /CIAngel/wings.json (Which is downloaded automatically on first launch) to search for the name entered.
 
== Download queue ==
Download queue:
When viewing the search result list, you can press X to add the title to the download queue. Selecting &quot;Process download queue&quot; will allow you to then download or install all of the queued titles one after another. This uses the currently selected download/install mode.
* When viewing the search result list, you can press X to add the title to the download queue.  
== Input.txt support ==
* Selecting Process Download Queue will allow you to then download or install all of the queued titles one after another. Uses currently selected download/install mode.
CIAngel can read a text file (sd:/CIAngel/input.txt) that has 2 lines. The first line must be the title id. The second line must be the encrypted title key.
 
== Thanks! ==
Input.txt support:
CIAngel has been developed with many contributions from the community, both ideas and code contributions. Many thanks to the following (non-exhaustive) list of contributors!
* It can read a text file (sd:/CIAngel/input.txt) that has 2 lines.
* Cearp
* The first line must be the title id. The second line must be the encrypted title key.
* Drakia
 
* superbudvar
==Changelog==
* mysamdog
'''v0.81 2017/05/12'''
* cerea1killer
 
* machinamentum for the original FirmwareDownload code
Development Changes:
* Steveice10 for many insights into CIA handling in FBI
* Update 'buildtools' external.
== Building ==
* Update to build with the latest ctrulib/devkitARM.
CIAngel has a few dependencies required to build, as well as a git submodule that will need to be fetched. When initially fetching the project, the easiest way to get the code and submodules for building is the following: <code>git clone --recursive https://github.com/llakssz/CIAngel.git</code> If you have already checked out the code without the submodules, you can run the following command in the project directory to fetch the submodule data: <code>git submodule update --init --recursive</code> CIAngel depends on the following projects:
 
* The latest version of [https://github.com/smealum/ctrulib libctru]
User Changes:
* The latest version of [https://gbatemp.net/threads/hbkblib-a-3ds-keyboard-library.397568/ hbkb]
* New 'Homebrew' startup screen.
== Building and installing HBKB ==
* Update URL to new site.
HBKB doesn't currently have a 'make install' command, and has to be manually installed once built.
* Allow overriding the URL for wings.json with a /CIAngel/source.txt file (single line, URL to the json_enc file).
# You will need to modify the Makefile to remove the DEVKITARM define at the top
* Use the system keyboard instead of a custom software keyboard.
# Once you have run 'make', you will need to copy the resulting lib and header to your DEVKITARM directory: <code>cp hbkb/lib/libhbkb.a $DEVKITPRO/libctru/lib</code> <code>cp hbkb_include_header/hbkb.h $DEVKITPRO/libctru/include/</code>
 
# Hopefully CIAngel now builds for you!
'''v0.80 2016/-5/29'''
* Remove existing ticket/title data before installing, incase a bad ticket is already installed.
* Add seed entry for installed games (no more need for cryptofixing).
* Add region to generated CIA file names.
 
[https://github.com/llakssz/CIAngel/releases Revision changelog.]
 
==Credits==
Many thanks to the following (non-exhaustive) list of contributors:
* Cearp.
* Drakia.
* superbudvar.
* mysamdog.
* cerea1killer.
* machinamentum for the original FirmwareDownload code.
* Steveice10 for many insights into CIA handling in FBI.
 
==External links==
* GitHub - https://github.com/llakssz/CIAngel
* GBAtemp - https://gbatemp.net/threads/release-ciangel-download-good-cias-right-on-your-3ds.423326
 
[[Category:3DS homebrew applications]]
[[Category:Homebrew utility applications on 3DS]]

Revision as of 01:55, 20 July 2021

Template:Infobox 3DS homebrew

CIAngel is a homebrew program that can download CIAs directly on your 3DS. It is a fork of FirmwareDownloader from machinamentum.

Note: The project is obsoleted.

User guide

Search by name:

  • CIAngel utilizes HBKBlib to search for titles by name. Data is read from /CIAngel/wings.json (Which is downloaded automatically on first launch) to search for the name entered.

Download queue:

  • When viewing the search result list, you can press X to add the title to the download queue.
  • Selecting Process Download Queue will allow you to then download or install all of the queued titles one after another. Uses currently selected download/install mode.

Input.txt support:

  • It can read a text file (sd:/CIAngel/input.txt) that has 2 lines.
  • The first line must be the title id. The second line must be the encrypted title key.

Changelog

v0.81 2017/05/12

Development Changes:

  • Update 'buildtools' external.
  • Update to build with the latest ctrulib/devkitARM.

User Changes:

  • New 'Homebrew' startup screen.
  • Update URL to new site.
  • Allow overriding the URL for wings.json with a /CIAngel/source.txt file (single line, URL to the json_enc file).
  • Use the system keyboard instead of a custom software keyboard.

v0.80 2016/-5/29

  • Remove existing ticket/title data before installing, incase a bad ticket is already installed.
  • Add seed entry for installed games (no more need for cryptofixing).
  • Add region to generated CIA file names.

Revision changelog.

Credits

Many thanks to the following (non-exhaustive) list of contributors:

  • Cearp.
  • Drakia.
  • superbudvar.
  • mysamdog.
  • cerea1killer.
  • machinamentum for the original FirmwareDownload code.
  • Steveice10 for many insights into CIA handling in FBI.

External links

Advertising: