Difference between revisions of "MobileTerminal"

From The iPhone Wiki
Jump to: navigation, search
m (Summary: Added info on both MobileTerminal's. Used the apt-get install name.)
(remove some non-general/outdated info; note the various versions of mobileterminal)
Line 1: Line 1:
 
[[Image:MobileTerminal.png|thumb]]
 
[[Image:MobileTerminal.png|thumb]]
  +
'''MobileTerminal''' is a terminal emulator for iOS. It was originally written for iPhone OS 1.x, and therefore was built with an unofficial SDK. This is labelled "MobileTerminal (Obsolete)" in Cydia. It was later ported to use the official SDK, however it was never finished.
== Summary ==
 
Application used to execute shell commands in iPhone OS. Some of it's features are still missing in 2.x.x firmwares.
 
 
There are two main forks currently available: '''MobileTerminal''', written with Apple's SDK, and '''Terminal+''', which supports more features. Saurik's ''Telesphoreo'' repo hosts, under the "MobileTerminal" name, an iPhone OS 3.1.3 and older compatible version of Terminal+. There is mobileterminal which supports firmware below 4.0 and for above 4,0, mobileterminal-applesdk.
 
   
 
== Controls ==
 
== Controls ==
 
The Control key is mapped to the "bullet" key (black circle on the second page of symbols of the on screen keyboard).
 
The Control key is mapped to the "bullet" key (black circle on the second page of symbols of the on screen keyboard).
 
To run some software you must have <code>root</code> privileges. Run the <code>su</code> command and enter the password for the root account. (<code>alpine</code> by default, you may change it with the <code>passwd</code> command).
 
Root access is shown by default as a prompt ending in <code>#</code> as opposed to <code>$</code> (non-privileged user).
 
 
=== Controls (MobileTerminal) ===
 
   
 
MobileTerminal features a shortcut menu (blue upwards arrow icon) which can be customized from the settings ("i" icon) page.
 
MobileTerminal features a shortcut menu (blue upwards arrow icon) which can be customized from the settings ("i" icon) page.
Line 17: Line 9:
 
Bluetooth keyboards are supported.
 
Bluetooth keyboards are supported.
   
  +
MobileTerminal launches your shell as the mobile user, so therefore not everything will work. If an operation requires root permissions, you can elevate by running <code>su</code>, and entering root's password (<code>alpine</code> by default). The default configuration of bash will also change the prompt's <code>$</code> to a <code>#</code>.
==== Installation Warning ====
 
   
  +
=== Terminal+ ===
When installing MobileTerminal from YourCydiaRepo.org, you get additional software advertised as updates on Cydia's ''Changes'' page. And if you remove the repo after installing MobileTerminal and then go to Cydia's ''Changes'' page, Cydia crashes.
 
  +
Control-C can also be accessed with a short Up-Right and Control is a short Down-Right swipe, after which the cursor will turn highlight red, from here press any character q, x, c, A to complete or the delete button to exit Control mode.
   
  +
Escape is Control-[ or a short Up-Left swipe, which may come in handy with vi. Tab is Control-I or a short Down-Left swipe.
=== Controls (Terminal+)===
 
You can send a control-C by pressing the "bullet" key (First press ".?123", then "#+=", then the circle on the middle right), then press the C key. This can be useful when you want to escape out of a long running program such as ping. Control-C can also be accessed with a short Up-Right and Control is a short Down-Right swipe, after which the cursor will turn highlight red, from here press any character q, x, c, A to complete or the delete button to exit Control mode.
 
   
  +
The keyboard-to-gesture mappings can be reassigned via the preferences. To invoke it, tap and hold on screen, then move finger to "misc" and then to "config".
Escape is control-[ or a short Up-Left swip, which may come in handy with vi. Tab is control-I or a short Down-Left swip (yay tab completion).
 
   
  +
== Forks ==
All this keyboard-to-gesture mappings can be reassigned via Preferences dialog. To invoke it, tap and hold on screen, then move finger to "misc" and then to "config".
 
  +
As the project appears to be abandoned, various forks have appeared. A search for MobileTerminalAppDelegate.m on [https://github.com/search?q=MobileTerminalAppDelegate.m&ref=cmdform&type=Code GitHub] shows the majority of them.
   
  +
Notable forks include:
== Links ==
 
  +
  +
* [https://github.com/hbang/NewTerm NewTerm] (available on cydia.hbang.ws)
  +
* [https://github.com/coolstar/MobileTerminal MobileTerminal+] (available on repo.coolstar.org)
  +
  +
Since the newer build wasn't available on Cydia for a long time, various repos host a copy of it. Notably, weamdev.org/repo contains a build compiled with the iOS 7 SDK and support for the 4" iPhone screen.
   
  +
== Links ==
*[http://code.google.com/p/mobileterminal/ Homepage]
 
*[http://code.google.com/p/mobileterminal/downloads/list iOS 4-compatible versions]
+
* [http://code.google.com/p/mobileterminal/ MobileTerminal Google Code project]
*[http://code.google.com/p/mobileterminal/wiki/Installation Installation guide for beginners]
+
* [http://code.google.com/p/mobileterminal/wiki/TipsAndTricks User guide]
*[http://code.google.com/p/mobileterminal/wiki/TipsAndTricks User guide]
 

Revision as of 06:36, 15 February 2014

MobileTerminal.png

MobileTerminal is a terminal emulator for iOS. It was originally written for iPhone OS 1.x, and therefore was built with an unofficial SDK. This is labelled "MobileTerminal (Obsolete)" in Cydia. It was later ported to use the official SDK, however it was never finished.

Controls

The Control key is mapped to the "bullet" key (black circle on the second page of symbols of the on screen keyboard).

MobileTerminal features a shortcut menu (blue upwards arrow icon) which can be customized from the settings ("i" icon) page. It is also possible to map certain actions to gestures (none are set by default). Bluetooth keyboards are supported.

MobileTerminal launches your shell as the mobile user, so therefore not everything will work. If an operation requires root permissions, you can elevate by running su, and entering root's password (alpine by default). The default configuration of bash will also change the prompt's $ to a #.

Terminal+

Control-C can also be accessed with a short Up-Right and Control is a short Down-Right swipe, after which the cursor will turn highlight red, from here press any character q, x, c, A to complete or the delete button to exit Control mode.

Escape is Control-[ or a short Up-Left swipe, which may come in handy with vi. Tab is Control-I or a short Down-Left swipe.

The keyboard-to-gesture mappings can be reassigned via the preferences. To invoke it, tap and hold on screen, then move finger to "misc" and then to "config".

Forks

As the project appears to be abandoned, various forks have appeared. A search for MobileTerminalAppDelegate.m on GitHub shows the majority of them.

Notable forks include:

Since the newer build wasn't available on Cydia for a long time, various repos host a copy of it. Notably, weamdev.org/repo contains a build compiled with the iOS 7 SDK and support for the 4" iPhone screen.

Links