Installing Sapphire Manually Sapphire Browser

Installing Sapphire Manually Sapphire Browser

Installing Sapphire Manually

These instructions are intended to be used to install Sapphire Manually on your AppleTV. You will probably only need to do this if Sapphire is unavailable through the ATVLoader (it takes a little while for new versions to get approved by AwkwardTV to be listed).

-WARNING- READ THIS TUTORAIL FIRST. If you are not confident in what you are going to be doing PLEASE DON’T PREFORM THIS TYPE OF INSTALLATION and wait for the ATVLoader to be updated.

1. We need the IP address for the AppleTV - to find it go to the AppleTV’s Menu and select Settings -> Network. For these instructions we will assume the IP Address is 192.168.100.100.

2. We need to make sure SSH is enabled. To turn it on, go to the Awkward TV plugin and select the SSH Service button. The button will say “SSH Service Enabled” when it’s turned on.

3. Now we need to SSH into the AppleTV. Using the terminal* type: “ssh -1 frontrow@192.168.100.100″. Remember to use your AppleTV’s IP Address.

4. The password is “frontrow”

5. Now we need to make sure we can write to the OSBoot volume. Using the terminal* type: “sudo mount -uw /”. Again, the password is “frontrow”.

6. Now our AppleTV is ready for an install. If you already have a version of Sapphire Installed we need to remove it. Using the terminal* type: “sudo rm -r /System/Library/CoreServices/Finder.app/Contents/PlugIns/Sapphire.frappliance”.

7. Now we need to get the new version on the AppleTV. From your computer, copy the Sapphire.frappliance folder on to your AppleTV’s frontrow partition.

8. Now we need to move the Sapphire.frappliance folder from the frontrow partition to the OSBoot partition. Using the termianl* type: “sudo mv ~/Sapphire.frappliance /System/Library/CoreServices/Finder.app/Contents/PlugIns/”

9. Almost done! we just need to reload the AppleTV’s UI. Using the terminal* type: “sudo reboot”.

10. Wait for the AppleTV to reboot.

* To open a terminal window type “Terminal” into spotlight - it will be the top hit.

Exif Jpeg header manipulation tool

Exif Jpeg header manipulation tool

Pre-built OS-X Intel executable	jhead	(61 k)
Pre-built OS-X PPC executable	jhead	(67 k)

The program also has a lot of other command line options for manipulating Exif files, such as options to manipulate the date in the header, renaming image files, or coordinating running Jpegtran and Mogrify to manipulate whole directory trees of images.

Here's the program files. Just right click and save as. The source archives should end in .tar.gz (as in jhead-2.7.tar.gz). Windows browsers have the annoying habit of renaming files on saving, so you may have to rename the file back to what is shown for programs to recognize them properly. You can use WinZip to open .tar.gz files.

For novice Linux/Unix/OS-X users: Don't forget to set the executable bit after downloading the pre-built executables. Type "chmod +x jhead" at a shell window after downloading it to do this. You don't have to do this if you use one of the RPM packages.

I don't at this point have an OS-X machine to build the binary on, nor do I have a RedHat system to build the RPM for that anymore. Until somebody builds it for me for those platforms, just use the previous release - it works just fine.

NitoTV - AwkwardTV

NitoTV - AwkwardTV

Install Howto

To install it, you will need to copy the NitoTV folder from nitoTVInstaller.zip into your AppleTV. You can copy it to the home folder of the 'frontrow' user if you wish, although its location doesn't really matter.

Next, you need to open an SSH connection to your AppleTV, like so:

ssh -1 frontrow@AppleTV.local

When prompted for a password, enter 'frontrow'.

Now go to the directory where you placed this folder on your AppleTV and type the following command:

chmod 755 installme

sudo ./installme

When prompted for a password, enter 'frontrow' again

To fix permission
sudo mount -uw /
cd /System/Library/CoreServices/Finder.app/Contents/PlugIns/nitoTV.frappliance/Contents/Resources/
sudo chmod 755 nitoHelper
sudo chmod u+s nitoHelper

To enable USB drive

cp -R mach_kernel.prelink /

The Unix Command Line: Administration

The Unix Command Line: Administration

Reference Tips Mac OS X Info Tech Notes How-to's		OS X's BSD/unix command-line System Administration Commands By Gordon Davisson Copyright (c) 2003, Westwind Computing inc. Index: Basic Navigation (cd, pwd, ls) Manipulating Files & Folders (cp, CpMac, ditto, mv, rm, rmdir, mkdir, chmod, chflags, chown, chgrp) Working with Text Files (more, less, grep, pico, vi, emacs; text file formats) Pipes and Redirects (>, >>, <, |, tee) Miscellaneous (man, apropos, find, locate, open) Administration (ps, top, kill, su, sudo, lsbom, lsof, ifconfig, diskutil) Single-user mode (fsck, mount, SystemStarter, pico, nicl, bless, exit, reboot, shutdown)
Administration Commands: ps - List the processes running on the system Examples: ps List processes belonging to the current user that are attached to a terminal (not very useful under OS X) ps -x List processes belonging to the current user whether or not they're attached to a terminal ps -ax List all running processes ps -aux List all running processes, with additional information about their resource useage top - List the top CPU-consuming processes running on the system, along with various other system load statistics. Note: it runs continuously, updating the stats repeatedly, until you quit it with "q". Examples: top Display a list of processes, highest-process-id (i.e. most recent) first, updating once a second top -us5 Display processes sorted by CPU useage, updating every 5 seconds kill - Kill (or send other signals to) a process Examples: kill 220 Terminate process #220 kill -9 220 Terminate process #220 with extreme prejudice kill -HUP 220 Send process #220 a hangup signal - by convention, background processes (daemons) treat this as a cue to restart, and reload their configuration information. su - Set user. Allows you to temporarily become another user (root is the default). It'll ask for that user's password. Use the "exit" command to go back to normal. Note: You must be a member of the "wheel" group to su to root; under OS X 10.2, nobody is a member of "wheel" so this is effectively forbidden. Use sudo instead. sudo - Set user and do. Execute a single command as another user (root is the default). It will ask for your password. Access is controlled by a configuration file and can be made quite complex (see the man page). By default, any administrator use sudo to perform any command as any user. Examples: sudo rm /private/var/db/.AppleSetupDone Become root just long enough to delete one file. sudo -u george ls ~george/Documents Become george and list the files in his Documents directory. sudo -s Start a root shell (similar to su, except that it asks for your password, rather than the root password, and doesn't requires admin access, not wheel membership). lsbom - List the contents of an installer's bom (bill of materials) file. This can be used to find out what files an installer will add/replace in your system before running it. It can also be used to find out what files a past install messed with. Examples: lsbom /Volumes/Developer\ Tools/Packages/DevTools.pkg/Contents/Resources/DevTools.bom >contents.txt List the files that will be installed by the "DevTools" package, saving the list in a file named contents.txt. lsbom /Library/Receipts/Essentials.pkg/Contents/Resources/Essentials.bom | more List the files that were installed by the "Essentials" package (and pipe it through more to prevent overload). lsof - List open files on the system. Normally, it only lists files you (or processes you own) have open; if run as root, it lists all open files. Examples: lsof List all files currently open by me and my processes. sudo lsof List all files currently open on the entire system. sudo lsof -i List all open network connections on the entire system. sudo lsof "/Volumes/FW Drive" List all open files on the "FW Drive" volume; useful for figuring out why you can't eject/dismount a disk because something is using it. ifconfig - Configure network interfaces (e.g. ethernet ports, AirPort cards, etc). Notes: In general, it's better to adjust the network settings in the Network pane of System Preferences. ifconfig sometimes allows a little more control/information, but changes made this way will almost never "stick" when the computer is rebooted, and may get reset when the network settings change (e.g. if the location changes, a port gets connected or disconnected, etc). Changing the network settings requires root access. ifconfig refers to network ports using rather cryptic identifiers such as: en0 The first ethernet interface (generally, the built-in ethernet port). en1, en2, etc Additional ethernet interface(s) and/or AirPort wireless network card(s), firewire, etc. lo0 The local loopback pseudo-interface, which your computer uses to talk to itself. Don't worry, this is not a sign of schizophrenia, it's just the way unix systems work... Examples: ifconfig -a List the computer's network ports and their settings. sudo ifconfig en0 media 100baseTX mediaopt full-duplex Set the built-in ethernet interface to 100-megabit, full-duplex mode. Note that this may or may not have any effect, depending on whether the driver supports this form of configuration-forcing. sudo ifconfig en0 alias 10.0.0.150 netmask 255.255.255.0 Attach an additional IP address (aka an alias or subinterface) to the built-in ethernet port. Note that (at least as of OS X 10.2) this is probably better done by simply adding another port configuration in the Network preference pane. diskutil - Provides various utilities for dealing with Apple's disk format options (HFS+, journaling, RAID, etc). Many options require root access. Examples: diskutil Display a list of diskutil's options. diskutil info / List information on the boot volume. diskutil info /Volumes/Data List information on a mounted (non-boot) volume named "Data". diskutil info /dev/disk0s9 List information on partion #9 of disk #0. sudo diskutil repairDisk /Volumes/Data Repair the file structure on the volume "Data" (note: this unmounts the volume during repair). sudo diskutil repairPermissions / Repair the file permissions on the boot volume. sudo diskutil enableJournal / Enable HFS+ journaling on the boot volume. sudo diskutil disableJournal / Disable HFS+ journaling on the boot volume.

61. Handy Unix Network Troubleshooting Commands

61. Handy Unix Network Troubleshooting Commands

Introduction to Data Communications 61. Handy Unix Network Troubleshooting Commands 1. Handy Unix Network Troubleshooting Commands The following network troubleshooting commands will vary slightly in syntax depending on which operating system is used. Some operating systems will provide more options and some less. Please use the following information as a guide and the syntax presented with "a grain of salt". arp Use this command to see the IP to MAC address translation table if you are having problems connecting to other network hosts. It is a dynamic cache which updates every 120 seconds. ARP stands for Address Resolution Protocol (ARP). arp - a address resolution protocol host name (IP address) at (ethernet address) ping The ping command is the most versatile network troubleshooting command in Unix. Use it to verify that your TCP/IP network services are operating correctly. The ping command allows you to determine that the: TCP/IP stack is configured properly Network interface card is configured properly Default gateway and subnet mask is configured properly Domain name services is configured properly. The following is a step by step guide in determining if your network stack is configured properly: ping 127.0.0.1 Checks that your TCP/IP stack is working properly up to the network interface card (NIC). If this fails, check to see if you have TCP/IP services loaded. ping "IP address of default gateway" Checks that the network interface card is working on the local subnet by pinging the local side of the default gateway which is a router. If this fails, check that TCP/IP is bound to the NIC. Then check that the NIC's IRQ, and base address are set properly both on the card itself and in the operating system's interface configuration. ping "IP address across the gateway" Checks that the default gateway is correctly identified in the TCP/IP configuration and that the proper subnet mask is configured. The IP address selected must not be on the local subnet. ping "domain name" Checks that the domain name services (DNS) is correctly configured in the TCP/IP stack. A domain name is a name like www.yahoo.com. If it fails, check that the DNS server's IP address is entered in properly in the TCP/IP configuration. netstat The network status command netstat displays status information about the network interfaces on the host machine and it can display routing table information. Local interface status netstat -ain a - all interfaces are displayed i - displays configuration n - IP addresses (!n - host names) example output: Name MTU Net/dest address Ierrs Opkts Collis Queue le0 1500 (net IP addr) (local IP) . .. ... .... Routing table information netstat -r (-nr or rn gives ip addresses) Routing Table Destination Gateway Flags Interface (net or host) (IP address) UHGD (name) U - up H - host G - gateway D- discovered using ICMP Req ifconfig The ifconfig command is used to display the local interface configuration (winipcfg for Windows) and to modify the configuration. Local interfaces can be Ethernet network cards, modems, etc.. ifconfig (interface name) (down/up/nothing) nothing gives status (interface name): flags - 63 (up, broadcast, notra, Running) inet (ip address) netmask FFFFFF00 broadcast 128.6.7.255 route The route command allows you to add static routes to the routing tabling. route (-n) (add/delete/nothing) (dest IP address/subnet/DEFAULT) (local IP address) (hop) traceroute (tracert in Windows) Traceroute displays the routers that are passed through to reach the destination. traceroute "IP address or domain name" Tracing route to www.apllejcok.com [192.168.1.64] over a maximum of 30 hops: 1 116 ms 134 ms 112 ms ts10.dshark.com [192.168.128.20] 2 124 ms 112 ms 114 ms bl1.poufe.com [192.168.130.1] 3 122 ms 118 ms 117 ms fifo.amalag.com [192.168.64.2] 4 130 ms 156 ms 132 ms dfg.apllejcok.com [192.168.1.1]

Introduction to Data Communications
Previous	Table of Contents	Next

AFP

Wednesday, April 2, 2008

AFP-

AFP
Some Patchstick-Instructions were replacing the Kerberos.framework file of the AppleTV. This is causing some problems. In particular, mount_afp fails with "Illegal instruction".

So be sure to have the following Directory-Structure on your ATV:

Code: Select all

/System/Library/Frameworks/
/System/Library/Frameworks/Kerberos.framework/
/System/Library/Frameworks/Kerberos.framework/Versions/
/System/Library/Frameworks/Kerberos.framework/Versions/A/
/System/Library/Frameworks/Kerberos.framework/Versions/A/Kerberos

/System/Library/Frameworks/OSXFrames/
/System/Library/Frameworks/OSXFrames/Kerberos.framework/
/System/Library/Frameworks/OSXFrames/Kerberos.framework/Kerberos
/System/Library/Frameworks/OSXFrames/Kerberos.framework/Resources/
/System/Library/Frameworks/OSXFrames/Kerberos.framework/Versions/

1st Kerberos is 40408 / md5 5a2805de06aea5a4b52be9fbd95c65e6
2nd Kerberos is 2322540 / md5 e110e4e8c1d6ea881ced60c996836487


Check also the /usr/libexec/sshd-keygen-wrapper. The wrapper should contain the following line at the end:

Code: Select all

DYLD_FRAMEWORK_PATH="/System/Library/Frameworks/OSXFrames" exec /usr/sbin/sshd $@

...if not, run:

Code: Select all

sed -i"" -e 's;^exec;DYLD_FRAMEWORK_PATH="/System/Library/Frameworks/OSXFrames" exec;' /usr/libexec/sshd-keygen-wrapper

This works on my ATV just perfect and I can mount the Time Capsule HD through AFP! Of course SSH v1 and v2 works too

Cheers

========================================================

Ok, finally got afp working according to the instructions in this post.

viewtopic.php?f=2&t=1338&st=0&sk=t&sd=a&start=20#p8283

To summarize these are the steps I took to solve the "illegal operation" error.

Please note that you are working with two different versions of Kerberos.framework, one from the MacOSX update package, and the other from the AppleTV restore partition. These are not interchangeable and are the cause of all the "illegal operation" errors

1) Copy /System/Library/Frameworks/Kerberos.framework from the MacOSXCombo10.4.8Intel.pkg to your AppleTV home directory. (10.4.9 would probably work as well, but I haven't tried it)

2) create the /System/Library/Frameworks/OSXFrames directory

Code: Select all

sudo mount -uw /
sudo mkdir /System/Library/Frameworks/OSXFrames

3) Copy Kerberos.framework from your AppleTV home directory to the OSXFrames directory

Code: Select all

sudo cp -pr ~/Kerberos.framework /System/Library/Frameworks/OSXFrames/

3) On the AppleTV run the sed command.

Code: Select all

sudo sed -i"" -e 's;^exec;DYLD_FRAMEWORK_PATH="/System/Library/Frameworks/OSXFrames" exec;' /usr/libexec/sshd-keygen-wrapper

4) mount the recovery partition

Code: Select all

cd ~
sudo dd if=/dev/disk0s2 of=recovery.dmg bs=1m
sudo hdiutil mount recovery.dmg
sudo hdiutil mount /Volumes/Recovery/OS.dmg

5) copy the Kerberos.framework from your recovery image to the proper directory (Note: I have a 1.0 recovery partition, a 1.1 may not work)

Code: Select all

sudo cp -pr /Volumes/OSBoot\ 1/System/Library/Frameworks/Kerberos.framework /System/Library/Frameworks/

at this point I lost my ssh connection, you may have to log back in using sshV1 (ssh -1 frontrow@appletv.local). Thank-you sugarola.

6) repair permissions

Code: Select all

sudo /usr/sbin/diskutil repairPermissions /

7) Mount the shared drive

Code: Select all

mount_afp afp://username:password@myMac.local/SharedDrive ~/MountPoint

You should now have both ssh2 and working afp.

Once again I would like to thank everyone on this board for helping out.

===============================================================

@jayfehr

Nice tutorial

But you should add something (above 4.) If you don't run "afpinstall.sh" the file recovery.dmg is missing. You can obtain the file running:

Code: Select all

sudo mount -uw /
cd ~
sudo dd if=/dev/disk0s2 of=recovery.dmg bs=1m

Cheers
================================================================
@The stig

One other thing I had not mentioned in the tutorial was that when installing afp I did NOT use the afpinstall.sh script, I used the manual install process from the Take 2 Full Update wiki (http://wiki.awkwardtv.org/wiki/Take_2_Full_Update) This method copies over many, many more files then the script, some of which may be relevant. Also these may only work on a 1.0 AppleTV, if you are running a different version these instructions may not help. Also after running the manual process be sure to run:

Code: Select all

sudo /usr/sbin/diskutil repairPermissions /

As mentioned in one of the comments below the manual instructions (those comments do not include the "sudo" or final "/" which are very important

Anyway here is the info you asked for:

From the MacOSXUpdCombo10.4.8Intel (now installed in the OSXFrames dir on the AppleTV)
-rwxr-xr-x 1 frontrow frontrow 2322540 Sep 8 2006 /System/Library/Frameworks/OSXFrames/Kerberos.framework/Versions/A/Kerberos
MD5 (/System/Library/Frameworks/OSXFrames/Kerberos.framework/Versions/A/Kerberos) = 2b7df04894c3dca1704c095bf3f3e1fc

From the AppleTV Restore partition (now installed in the Frameworks dir on AppleTV)
-rwxr-xr-x 1 frontrow frontrow 40408 Mar 14 2007 /System/Library/Frameworks/Kerberos.framework/Versions/A/Kerberos
MD5 (/System/Library/Frameworks/Kerberos.framework/Versions/A/Kerberos) = d1da821aab78143be38f9a58471cc99c

AwkwardTV Community & Forums • View topic - nitoTV 0.3.1a/b (take two) released!

AwkwardTV Community & Forums • View topic - nitoTV 0.3.1a/b (take two) released!: Sorry another release right before work (it was either that or chancing not till tomorrow- sorry) update as usual internally (if you already have nitoTV installed) settings - > install software - > update nitoTV

or

http://nitosoft.com/nitoTVInstaller_tt.zip

heres a clip from the about file on update info.

General Update Info 0.3.1
===================

The fixPerm script works again, AND the installer section is more lenient with which permissions are acceptable to run. More importantly, the smart installer will work from a 1.0 AppleTV restore image. So if you have a copy of the recovery.dmg from a 1.0 AppleTV in the /Users/frontrow/Documents folder it will install AFP, install scripting components (fixes POD and emulators in take 2 full), remote desktop and perl. The play folder bug is fixed, and DVD playback should go to mplayer again rather than just locking up. We have cover art viewing and generating returning, unplayed markers as well, coming much closer to catching the Take 2 version up to the 1.x functionality.

Lack of time:

1. File Copy / Paste

Potential code re-writes:

1. On screen display in quicktime
2. dvd playback framework (dvd plays in mplayer for now)
3. metadata



--

Bit of a delayed post update, the release day was a busy day as was yesterday. there appears to be a REALLY stupid problem with the permission check that i THOUGHT i totally fixed when doing the transition to leopard but i guess i didnt. sorry about that- the following code will fix the permission check for any installers that arent working.

Code: Select all

sudo mount -uw /
cd /System/Library/CoreServices/Finder.app/Contents/PlugIns/nitoTV.frappliance/Contents/Resources/
sudo chmod 755 nitoHelper
sudo chmod u+s nitoHelper

when i have more time this week im going to start up a new wiki for the take 2 version of nitoTV to focus on the differences between the two versions. (1.x and take 2)

the about file / section has all the updates as usual, no reason to post the info that is repeated in a few different places.


--

Two major changes in 0.2.2, perian installer and smart installer both are directly tested and verified to work in the full take 2 environment. smart installer will also take care of usb patching for take 2 (verified) as well same links as before. (or grab it internally if you already have 0.2.x installed)


---

beta 0.2, it's 4:45 am so ill keep it short.

download and follow install instructions

http://nitosoft.com/nitoTVInstaller_tt.zip

NOTES:

fixed the linker error with AppleShareClientCore.framework / AppleShareClient.framework. Will load, but bonjour section will still crash if those frameworks are missing. Smart installer SHOULD accomodate easy USB patching for 2.0 (untested in full 2.0, just followed instructions from full update wiki and made appopriate bsdiff files)

on a different note i finally got around to making a patchstick so i may backup my atv and do a full take 2 update and see if i can't make sure everything works properly and maybe get some of those update features from the full udpate wiki into the smart installer.. now that the plugin has returned more to its original capability i can look on towards new features again soon....

--

nitoTV version 0.2 (take two), Feb 28th, 2008.

Beta 2 welcomes back RSS, installation manager, file sizes, properly sorted menus, ejecting volumes, file deletion, playlist core data (playlist modes, shuffle, repeat), plenty of bug fixes and probably some things i forgot.

The lists have been reorganized, the top list is stuff I didn't have time to finish for this release, the second list are features that are going to require some re-writing that I haven't quite figured out yet.

Lack of time:

1. Music
2. Photos
3. unplayed / played markers

Potential code re-writes

1. On screen display in quicktime
2. volume / sub / audio toggling in quicktime
3. dvd playback framework (dvd plays in mplayer for now)
4. Cover art / preview auto generation
5. metadata

--

okay heres the first take two release, (is kind of alpha/beta stage) ill update the wiki and more later after i get back from work.

download and follow install instructions

http://nitosoft.com/nitoTVInstaller_tt.zip

for now heres a carbon copy of the about section for some basic information on what doesn't work yet
---
nitoTV version 0.1 (take two), Feb 23rd, 2008.

Alright at long last, the first alpha/beta of nitoTV for Take 2. This is a bit of a slimmed down version and some things got 86'ed in favor of a faster release. The following does not work yet.

1. Music
2. Photos
3. On screen display in quicktime
4. volume / sub / audio toggling in quicktime
5. dvd playback framework (dvd plays in mplayer again for now)
6. emulators aren't exiting properly.
7. POD
8. RSS
9. Weather
10. Preview views / auto generation
11. unplayed / played markers
12. metadata

Most of the above wasn't implemented just for lack of time and for quicker initial release, some of the things will take longer because it appears i need to write some new code to accomodate some of the new graphic / video frameworks installed w/ Take 2.

Sorry for the barren about section, this will be better polished in the second release.