Date post: | 08-Apr-2015 |
Category: |
Documents |
Upload: | richiecruz |
View: | 123 times |
Download: | 3 times |
http://my.smithmicro.com
2
TableofContentsStuffIt2009forMacintosh 1
UserGuide 1
TableofContents 2
WelcomeandThanksforChoosingStuffIt! 7AboutUs 7What’sNewinStuffIt2009 8TheStuffItEngine 8ForMacOS10.5(Leopard)Users 8DropStuff 8StuffItArchiveManager 8SEAMaker 9
SystemRequirements 9
Overview 10WhatisStuffItfor? 10Compressing,Archiving,Encoding,Segmenting,Encryption…What’sitallmean? 10
StuffItProductFeatureComparisonChart 11
MoreabouttheStuffItProductsforMacintosh 12StuffItExpander 12BasicExpanderFeatures/Benefits 12AdvancedExpanderFeatures 12AdvancedExpanderFeaturesfortheStuffItDeluxeUser 12OtherExpanderFeatures 12
TheStuffItStandardSuite 13BasicDropStuffFeatures: 13AdvancedDropStuffFeatures: 13AdvancedDropStuffFeaturesfortheStuffItDeluxeUser 13OtherDropStuffFeatures 13
TheStuffItDeluxeSuite 13LinkstoQuickStartGuides 14GettingStartedwithStuffItExpander 14GettingStartedwithDropStuff 14TheStuffItQuickLookplugin 14GettingStartedwithMagicMenuandtheStuffItContextualMenu 14TheStuffItpluginforMacFUSE 14GettingStartedwithArchiveManager 14GettingStartedwithSEAMaker 14GettingStartedwiththeStuffItActionsforAutomator 14GettingStartedwiththeStuffItCommandLineTools 14
http://my.smithmicro.com
3
StuffItExpander‐GettingStarted 15Installation 15ExpandingFilesbyDoubleclick 15ExpandingFilesbyDragandDroptoApplicationIcon/DockIcon 15ExpandingFilesbyDragandDroptotheDragWindow 15FindingtheExpandedFiles 16ExpandingSegmentedFiles 16ExpandingEncryptedArchives 16
UpgradingfromStuffItExpandertoStuffItDeluxe 16
StuffItExpander‐AdvancedFeatures 17OneTimePreferences 17WatchFolder 17VirusScan 17Merging 17
AdvancedExpanderFeaturesfortheStuffItDeluxeUser 17AssignFileTypestobeOpenedwithArchiveManager 17MergingwithArchiveSpecifiedDestination 18ChangingExpander’sPreferences 18ExpansionPreferences 18DestinationPreferences 19FileMappings 20
OtherExpanderFeatures 20GrowlNotificationsupport 20Updatenotification 21AppleScriptsupport 21
ExpanderTroubleshooting 21
DropStuff‐GettingStarted 23Installation 23CreatingArchivesbyDragandDroptoApplicationIcon/DockIcon 23CreatingArchivesbyDragandDroptotheDragWindow 23AnoteaboutStuffItStandard’sPremiumfeatures 24PurchasingaLicense 24UpgradingfromStuffItStandardtoStuffItDeluxe 24DropStuff‐AdvancedFeatures 25SettingUpDropStuffProfiles 25DropStuffAdvancedFeatures 27AdvancedFeaturesfortheStuffItDeluxeuser 27StuffItIndexArchives 27OtherDropStuffFeatures 28
TheStuffItDeluxeSuite 29
TheStuffItQuickLookplugin 30
http://my.smithmicro.com
4
TheCoolestThing 30
MagicMenuandtheStuffItContextualMenu‐GettingStarted 31TheMagicMenu™ 31ExpandingwithMagicMenu 31CreatingArchiveswithMagicMenu 31MailOperations 31TheStuffItContextualMenu 31BrowsingArchivesviaMagicMenu 32LaunchingStuffItApplicationsviatheMagicMenu 32
MagicMenuandtheStuffItContextualMenu–AdvancedFeatures 33Growl 33CommandKeyShortcuts 33MenuItems‐TheCompleteList 33DisablingMenuItems 35PreventingMagicMenufromAuto‐loadingatLogin 35
ChangingMagicMenu’sPreferences 35ExpansionPreferences 35CompressionPreferences 36DestinationPreferences 37CompressionDestination 37ExpansionDestination 37
OtherMagicMenuFeatures 38
TheStuffItPluginforMacFUSE 39
TroubleshootingtheMacFUSEPlugin 40
StuffItSpotlightPlugin 41TroubleshootingtheStuffItSpotlightPlugin 41
StuffItIndexArchives 41UsingIndexArchives 42
StuffItArchiveManager‐GettingStarted 44FindingArchives 44OpeningArchivesinArchiveManagerfromtheFinder 45ChangingtheContentsofanArchive 45WorkingwithCustomCollections 45CreateArchivesfromCustomCollections 46TroubleshootingArchiveManager 46
ScheduledArchivingwithStuffItScheduler 47GettingStarted 47ChoosingtheSourceFiles 47SettingCriteria 47SettingtheDestination 48SchedulingtheTask 48
http://my.smithmicro.com
5
RestoringFiles 48OtherFeatures 49ArchiveManagerTroubleshooting 49
SEAMaker‐GettingStarted 50What’sanSEA? 50UsingSEAMaker 50AddingFiles 50SettingtheTargetDestination 50SpecifyingaRemotePayload 50DisplayingaSplashScreen 51DisplayingaTextDialog 51BuildingyourSEA 51CreatingaDiskImage 52RunningInstallers 52
StuffItActionsforAutomator‐GettingStarted 53WhatisAutomator? 53CreatingWorkflows 53SharingWorkflows 54Troubleshooting 54
StuffItCommandLineTools‐GettingStarted 55
ContactUs 56TechnicalSupport 56HowToContactSmithMicro 56SmithMicroRSSFeedsandMailingLists 56
AppendixA:SupportedFormats 57
AppendixB:AllaboutCompression 61Whatiscompression? 61Lossyvs.Losslesscompression 61Whycompress? 61Compressingvs.Archiving 61Encryption 61Encoding 62StuffItvs.StuffIt5vs.StuffItX 62
AppendixC:CreatingArchives 64ChoosingtheRightFormat 64ChoosingtheRightOptions 65Encryption 65PreserveMacintoshContent 65BackwardsCompatibleArchives 66
LegacyFormats 66AppendixD:FormatCompressionOptions 67StuffItXOptions 67
http://my.smithmicro.com
6
StuffItXExpertCompressionSettings 68CompressionMethod 68LevelsandExtents 69EncryptionMethod 70ErrorCorrection 70TextEncoding 70Optimizers 71BlockMode 71
ZipOptions 71ZipExpertCompressionSettings 72TarOptions 72TarExpertCompressionSettings 72TarCompressionMethod 72
AppendixE:GettingandDistributingtheFreeExpander 74
AppendixF:Acknowledgements 75
AppendixG:EndUserLicenseAgreement 78
AppendixH:Misc 83Patents 83Copyright 83
http://my.smithmicro.com
7
WelcomeandThanksforChoosingStuffIt!TheStuffItcompressionutilitiesenableyoutoworkwithawidevarietyofcompressedandencodedfileformats.WhilethecompressiontoolsbuiltintoMacOSXhavelimitedexpansionandcreationabilities(eg:theydonotsupportencryptionandonlyhandleaselectionofarchiveformats),weprovidetoolsforopeningover30differentfiletypes.OurStandardandDeluxesuitescreateseveralpopulararchiveformatsincludingourowncutting‐edgeStuffItXformat.Weprovideallmannerofoptionsincludingencryption,segmentingandencoding.OurDeluxesuiteoffersmanywaysworkwitharchives,easilyfindingthemanywhereonyourmachine;easilysearchingforfilesinsidearchives;peekinginsidearchiveswithoutopeningthemfirst;modifyingtheircontents,andmuchmore!
StuffItcomesinthreeflavors:Afree,stand‐aloneStuffItExpander;thesharewareStuffItStandardsuitewhichincludesExpanderandaddsthecompaniontoolDropStuffforcreatingarchives;andtheStuffItDeluxesuitewhichincludesthecomponentsfromStuffItStandardaswellasothertoolsforthathelpmakeworkingwithcompressedfileseasy.
ThisUserGuideisorganizedbycomponentsincludedintheStuffItExpander,StuffItStandardandStuffItDeluxesuites.Generally,documentationforeachcomponentisdividedintotwoparts:a“GettingStarted”sectionthatcoverthebasicsofusingthecomponentandan“Advanced”sectionthatprovidemoredetailedinformationaswellastroubleshootinginformation.
AboutUsWeknowcompression.StuffItwasoriginallycreatedfortheMacintoshin1987,andwaspublishedin1989byalittlecompanynearSantaCruz,CaliforniacalledAladdinSystems.Sincethencompanynameshavechangedandteammembershavecomeandgone,butwe’restillhereinWatsonville,astone’sthrowfromouroldoffices,stillcomingupwithwaystomakeyourfilessmallerandprovidethemostcomprehensivesuiteoffilecompressiontoolsavailable.
http://my.smithmicro.com
8
What’sNewinStuffIt2009WhileStuffIt2009sportsafreshlook,there’salotmoregoingon.Herearesomeofthehighlights:
TheStuffItEngine‐ SupportforexpansionofLZMAcompressedfiles(.lzma)‐ SupportforbrowsingofLZMAcompressedTarfiles(.tlzma,.tar.lzma)‐ SupportforexpansionofsegmentedZiparchives(.z01,.z02,etc.)‐ Supportforexpansionof7‐Ziparchives(.7z)‐ Supportforexpansionof"split"archives(.001,.002,.003,etc.)‐ StuffItXformat:"DuplicateFolding"‐WhencreatingaStuffItXarchive,ifa
duplicateitemalreadyexists,itisnotre‐addedtothearchive,butapointerisputinitsplace.Whenexpanded,theduplicatecontentisretrievednormally.Fordatasetswhereduplicateitemsexist,thiscansignificantlyreducethearchivesizeandcompressiontime.
ForMacOS10.5(Leopard)Users• Apluginthatallowscontentsofanybrowsablearchivetypetobepreviewed
withLeopard’sQuickLookfeature.ThenewStuffItpluginforQuickLookworksgreatwithTimeMachine–Leopard’sautomatedincrementalbackuptool.Youcanpreviewthecontentsofanysupportedarchive,withQuickLook,rightintheTimeMachinebrowser.AppleMailuserscanpreviewattachmentcontentswithoutfirstsavingthearchive,thenexpandingit.
• ApluginforGoogle'sMacFUSEthatallowsanybrowsablearchivetypetobe"mounted"inLeopard'sFinder,justlikeadiskordiskimage,viaviathenew"MountArchive"command,foundinMagicMenuandtheStuffItContextualMenu.(requiresinstallationofMacFUSE)
DropStuff• Profiles:SavenumerouspreferencesettingsasaProfile,thendragfilestothe
newDropTargetareastoexecute.AlternativelysavetheseProfilesintheFinderasDroplets.Example:CreateencryptedZipwithPreserveMacintoshContentoff,uploadtoMobileMeiDisk.orCreateStuffItXarchivewithMP3recompressionenabled,burntodisk.
• SupportforApple'sMobileMeservice‐AutomaticallyuploadtoyouriDisk.
StuffItArchiveManager• ZiparchivescontainingAppleDoubleencodedResourceForkscannowbe
modified.(Translation:MoreZipsareeditablenow...)• Browseencodedarchives:.sitx.hqx,.sitx.bin,.sit.hqx,.sit.bin,.zip.uu• SupportforApple'sMobileMeservice–Automaticallybackuparchivesto
youriDiskviaStuffItScheduler.
http://my.smithmicro.com
9
Morewaystofindthefilesyouarelookingfor:
• CustomCollections(ArchiveManager'ssmartsearches)cannowbeorganizedintofolders
• PreviewimagesinCustomCollectionseveniftheyarenotstoredinarchives.• Previewarchivecontentswithoutopeninganarchive• Previewimagesstoredinanyformatarchive.Thresholdlimitnowadjustable
toallowpreviewsoflargerimages.Previewsnowavailableinbrowsewindow.
SEAMaker• RemotePayload‐createmini‐installersthatcandownloadtheirpayload
fromanFTPserveroryourMobileMeiDisk.
SystemRequirementsMacOSX10.4Tigerrequiredforbasicfunctionality.
TheQuickLookplugin,andMacFUSEpluginrequireMacOSX10.5Leopard.
TheMacFUSEpluginrequiresthatGoogle’sMacFUSEbeinstalled(separatedownload).
GrowlnotificationsupportrequiresGrowltobeinstalled(separatedownload).
http://my.smithmicro.com
10
Overview
WhatisStuffItfor?IfyouimaginetheInternetasaseriesoftubes,youcanthinkofcompressed,encodedandencryptedfilesasdifferentpackagingsystemsusedtodeliverfilesfromoneplacetoanother.Generally,thepurposeofthesedifferentpackagingsystemsistogrouprelatedfilestogether,andtomakethemsmallersotheycanbestoredandtransmittedmoreeasily.
ThetoolsprovidedbyStuffIt,ataminimum,allowyoutoopenthesedifferentformats.StuffItStandardaddstheabilitytocreatearchivesandtheStuffItDeluxesuiteoffersmanymorewaystoworkwiththesefilesandoptimizeyourworkflow.
Compressing,Archiving,Encoding,Segmenting,Encryption…What’sitallmean?Compression:Compressionistheprocessofreducingafile'ssizethroughvariouspatternmatchingandtokenreplacementschemes.Manycompressionformats,likegzipandbzip2,onlyhandleindividualfiles,notfilesandfolders.
Archiving:Anarchiveisapackagethatcancontainmultiplefilesandfolders.Thecontentsofanarchivecanbecompressed,butsomearchiveformatssimplystoremultipleitemswithoutacompressioncomponent.StuffItandZiparchiveexamplesofarchivefiletypesthatusecompression,UNIXTapeArchives(.tar)areanexampleofanarchivefiletypethatdoesnotusecompression.
Segmenting:Onoccasion,youmayencounteranarchivethathasbeendividedintoseveralpieces.Typically,segmentationisusedtosplitalargearchiveoverseveraldisksortopostalargefileinseveralsmaller,easiertodownloadparts.
Encoding:InthecontextthatappliestoStuffIt,encodingreferstoaprocessbywhichabinary(8‐bit)fileistranslatedintoatext(7‐bit)file.BinHexandUUencodeareexamplesofencodingmethodsthatconvertbinaryintotext.Thisencodingmethodismostoftenusedwhenfilesaresentbyemail,orpostedontoUSENETNewsgroups.Mostoften,anencodedfilecontainsonlyoneitem,butoccasionallymultiplefileswillbeconcatenated(joined)togetherintoasingleencodedfile.
Encryption:Tokeeppryingeyesfromlookingatprivateinformation,filescanbesecuredwithpasswords–theircontentsscrambledandinaccessiblewithoutthecorrectkey.
Oftenthesedifferentschemesareusedincombination:mostarchiveformatsarecompressedandmanysupportencryption.Somepackagingoperationsareperformedoneaftertheothercreatingcompoundfilesthatarelikenesteddolls–packageswithinpackages.
http://my.smithmicro.com
11
StuffItProductFeatureComparisonChartFeatures Expander Standard
(Unregistered) Standard
(Registered) Deluxe
•Expand over 30 formats √ √ √ √
•AppleScript support √ √ √ √
•Create StuffIt X, Zip and Tar Archives √ √ √
•Create Custom Compression Profiles √ √ √
•Create Encrypted Archives √ √
•Create Segmented Archives √ √
•Compress & Burn to CD/DVD √ √
•Compress & Upload to FTP √ √
•Compress & Upload to MobileMe iDisk √ √
•Search for items stored in archives √
•Command center for working with compressed files √
•Preview images stored in archives √
•Preview archive contents without expanding √
•Scheduled archiving √
•Finder Integration with MagicMenu, StuffIt Contextual Menu,Spotlight, Quick Look, and MacFUSE plugins √
•Create Mini Installers √
•Automator Actions √
•Command Line Tools √
http://my.smithmicro.com
12
MoreabouttheStuffItProductsforMacintosh
StuffItExpanderExpanderopensmanyfilesanddoesitforfree!
BasicExpanderFeatures/Benefits• Easytouse.• Unobtrusive–itlaunches,expands,thenquits• Expansionsupportforover30formats(SeeAppendixA)• Free!AnyonecandownloadStuffItExpanderforMacorWindowsfrom
ourwebsite,FTPsite,andmanythirdpartyInternetsites‐AbsolutelyFree!
AdvancedExpanderFeatures• WatchFolder–Autoexpandfileswhentheyareaddedtoafolder• AutoScanforviruses–checkfilesforvirusesafterexpansion
automatically• Merging‐Ifthetargetfolderexists,mergethecontentskeepingolder
filesorreplacingwithnewerones.
AdvancedExpanderFeaturesfortheStuffItDeluxeUser• AssignfiletypestobeopenedwithArchiveManagerinbrowse‐mode• MergingwithArchiveSpecifiedDestinationtorestorefilestotheir
originallocations
OtherExpanderFeatures• Growlnotificationsupport• Updatenotification• AppleScriptsupport
http://my.smithmicro.com
13
TheStuffItStandardSuiteStuffItStandardincludesStuffItExpanderforopeningfilesandaddsthecompanionprogramDropStuffforcreatingcompressed,encryptedandencodedarchives.
BasicDropStuffFeatures:• EasytouseDragandDropinterface.• Unobtrusive–itlaunches,compresses,thenquits• CompressfilesintoStuffItX,Zip,andTararchives• Createencrypted(Passwordprotected)archives
AdvancedDropStuffFeatures:• Createarchivesfornon‐Macusers• CompressandEncodearchivesforuploading• CreateSegmentedarchives(split)• CompressandburnCD/DVD• CompressanduploadtoFTP• CompressanduploadtoAppleMobileMeiDisk
AdvancedDropStuffFeaturesfortheStuffItDeluxeUser• IndexArchives
OtherDropStuffFeatures• Growlnotificationsupport• VersionChecking• AppleScriptsupport
TheStuffItDeluxeSuiteStuffItDeluxeincludesStuffItExpanderandDropStuffandaddsFinderintegrationwiththeStuffItQuickLookplugin,theStuffItpluginforMacFUSEandeveneasierexpansionandarchivecreation,includinglegacyformatsupportviatheMagicMenuandtheStuffItContextualMenu;archivebrowsingandmanipulation;archivesearchingandscheduledarchivingviaArchiveManager;mini‐InstallercreationwithSEAMaker;workflowscriptingwithActionsforApple’sAutomatorandtheStuffItCommandLineTools.
http://my.smithmicro.com
14
LinkstoQuickStartGuidesClickthelinksbelowtojumpsectionforthecomponent.
GettingStartedwithStuffItExpander
GettingStartedwithDropStuff
TheStuffItQuickLookplugin
GettingStartedwithMagicMenuandtheStuffItContextualMenu
TheStuffItpluginforMacFUSE
GettingStartedwithArchiveManager
GettingStartedwithSEAMaker
GettingStartedwiththeStuffItActionsforAutomator
GettingStartedwiththeStuffItCommandLineTools
http://my.smithmicro.com
15
StuffItExpander‐GettingStarted
InstallationIfyou’vedownloadedthestand‐aloneStuffItExpanderorStuffItStandard,dragtheStuffItfolderfromthedownloadeddisktoyourApplicationsfolder.
Tip:StuffItStandardandExpander‐onlyusers,youcanaddExpandertoyourDockforconvenientaccess.JustopentheStuffItfolderanddragtheExpanderapplicationtoyourDock.
Note:OnesideoftheDockisforapplications;theotherisforfilesandfolders.
IfyouareaStuffItDeluxeuser,theinstallerhasputaStuffItfolderintoyourApplicationsfolderthatincludesStuffItExpanderandhasalsoautomaticallyaddedStuffItExpandertoyourDock.
Note:IfyouhaveolderversionsormultiplecopiesofStuffItExpanderyoushouldremovetheothercopies.
ExpandingFilesbyDouble‐clickManyofthefilesthataresupportedbyStuffItExpanderareautomaticallyassociatedwiththeprogramwhenitisinstalled.Thesewillbeidentifiedbyour“ballincube”icon.OpenthefileintheFinderbydouble‐clickingit.IfExpanderisclosed,theprogramwilllaunch,expandyourfilesandthenquit.
ExpandingFilesbyDragandDroptoApplicationIcon/DockIconSomefilesthatExpandercanopenmaynotbeassociatedwithit.YoucantrytoopenthembydraggingthemtoStuffItExpander’sapplicationorDockicon.
Tip:YoucanexpandmorethanonefileatatimebydraggingmultipleitemsontoStuffItExpander.
IfExpanderisclosed,theprogramwilllaunch,expandyourfilesandquit.
ExpandingFilesbyDragandDroptotheDragWindowWhenyoulaunchStuffItExpander,aDragWindowwillappear.YoucandragfilesanddropthemontotheStuffItExpanderDragWindowtoexpandthem.
http://my.smithmicro.com
16
FindingtheExpandedFilesWhenExpanderfinishes,theexpandedcontentwillbelocatedinthesamedirectoryastheoriginalfiles(thissettingcanbechangedinthepreferences).
Ifyounolongerneedtheoriginalfileyoucandiscardit.
Ifthereisa"packagewithinapackage"thatExpanderrecognizes,itwillcontinuetoexpandtheresultingfiles(thissettingcanbechangedinthepreferences).
ExpandingSegmentedFilesStuffItExpandercanjoinseveraltypesofsegmentedfiles.Tojoinasegmentedfile,youmusthaveallofthesegmentsinthesamelocation(ie:afolder).Tojointhesegmentsintoasinglefile,dragonlythefirstsegmentofthesetontoStuffItExpander.WhenExpanderisfinishedjoiningthesegments,theresultingfilewillbelocatedinthesamedirectoryastheoriginalsegments(thissettingcanbechangedinthepreferences).
IfthesegmentedarchiveyouwanttoexpandisstoredonmultipleCDsorDVDs,youcanexpandthesegmentsonebyone.Firstinsertthediskthatcontainssegment1,andthendraganddropthatsegmentontoStuffItExpander.AfterExpanderhasfinishedexpandingthefirstsegment,youwillbepromptedtoinsertthedisksthatcontaintheremainingsegmentsintheset.
ExpandingEncryptedArchivesStuffItExpanderwillpromptyoutoprovidethepassphrasebeforeencryptedfilescanbeexpanded.Ifyoudonothavethecorrectpassphraseyouwillnotbeabletoaccessthefilesstoredintheencryptedarchive.
That’sit.You’rereadytouseExpander!Continuereadingifyouwanttolearnmore,orcomebacklaterandexploreExpander’sAdvancedFeatures.
UpgradingfromStuffItExpandertoStuffItDeluxeTogetfilesoutofarchives,StuffItExpandercanonlyexpandtheentirecontents.StuffItDeluxeallowsyoutobrowsethecontentsofarchivesandselectivelyextractitems.DeluxealsoincludestoolsforcreatedarchivesinpopularformatssuchasZip,Tarandthecutting‐edgeStuffItX.WithDeluxeyoucanschedulecompressedbackups,searchforfilesstoredinarchives,previewimagesstoredinarchives,andautomateyourworkflowwithseveralscriptingoptions.Findoutmorehere:
http://my.smithmicro.com/mac/stuffitdeluxe/index.html
http://my.smithmicro.com
17
StuffItExpander‐AdvancedFeaturesBelowaresomeusefuloptionsmanyofwhichyoucansetinthePreferences.
OneTimePreferencesIfyouholddownthe"Option"keywhiledraggingfilestoStuffItExpander,youwillbepresentedwithaspecial"OneTime"Preferencesdialog.
Thisallowsyoutochangepreferencesettingsthatapplyonlytothecurrentoperation.Whenyouclick"OK"todismissthePreferencesdialog,yourfilewouldbeexpandedtothisnewlocationforthisonetime.Futureexpansionoperationswillusetheregularpreferencesettings.
WatchFolderSetExpandertoautomaticallyexpandfileswhentheyareaddedtoafolderofyourchoice,suchasyourDownloadsfolder.
VirusScanSetExpandertoautomaticallypassfilestoyourpreferredAnti‐Virusutilityfortestingafterexpansion.
MergingIfthetargetfolderexists,mergethecontents,keepingolderfilesorreplacingwithnewerones.
AdvancedExpanderFeaturesfortheStuffItDeluxeUser
AssignFileTypestobeOpenedwithArchiveManagerExpandingvsBrowsing:WhenfilesareopenedbyExpander,theywillbecompletelyexpanded.SomearchivesmaycontainmanyfilesandcanbebrowsedwiththeArchiveManagertool,ifpresent.Browsingallowsyoutoselectivelyextractindividualfilesfromanarchive.Youmayalsomodifythecontentsofsomearchiveswhenbrowsingthem.YoucandecidewhetherStuffItExpanderorArchiveManagerislaunchedwhenthesefilesaredouble‐clickedintheFinderbyadjustingExpander’sFileMappingpreferences.
http://my.smithmicro.com
18
MergingwithArchiveSpecifiedDestinationArchivescreatedwiththeStuffItSchedulerfeatureofArchiveManagercontainsourcepathinformationthatindicateswhereonthecomputerthefileswerewhentheywerearchived.ExpandingwiththespecialMergeoptionthatusesthispathinformationwillrestorethefilesbacktotheiroriginallocation.
ChangingExpander’sPreferencesYoucanchangethebehaviorofStuffItExpanderusingtheStuffItExpanderpreferencesdialog.ToopenStuffItExpanderpreferences,choosePreferencesfromthe"StuffItExpander"menuorclickthe"Preferences"buttononExpander’stoolbar.
ExpansionPreferencesTheExpandingPreferencesareusedtodeterminehowStuffItExpandergoesaboutthetaskofexpandinganarchiveorencodedfile.
Automaticallyexpandarchivesin...:ThissettingisusedtospecifyafolderthatExpanderwillperiodicallyscanfornewitemstobeexpanded.Anycompressed,archived,orencodedfilesplacedinthespecifiedfolderwillbeexpandedautomatically.
Continuetoexpandifpossible:Thispreference,whenenabled,causesStuffItExpandertoscantheexpandedoutputtoseeifitcanbefurtherexpanded.Forexample,expandingaBinHexencodedStuffItarchive(foo.sit.hqx),Expanderwillstarttoexpandthearchive“foo.sit”assoonasithasremovedtheBinHex(.hqx)encoding.
Note:Archives,compressed,andencodedfilescontainedwithinsubfoldersinthearchivemustbeseparatelyexpanded.
Setexecutepermissionsbydefault:ThispreferencedetermineswhetherExpandershouldsettheexecutefilepermissionattributeonitemsexpandedfromarchivesthatdonottypicallystoreUNIXfilepermissions,suchasZip(.zip)andtheolderStuffIt(.sit).Ifyouun‐checkthisbox,OSXapplicationsexpandedfromsucharchivesmaynotruncorrectly.
Note:StuffItXarchives(.sitx)aredesignedtopreserveUNIXpermissionsandignorethissetting.
Mountdiskimages:Whenthisoptionisenabled,Expanderwillattempttomountdiskimagefiles(resultingintheappearanceofa"virtualdisk").Apple'sDiskImageMounterisusedtomounttheimages.
http://my.smithmicro.com
19
Deleteafterexpanding:Whenenabled,thefilesyouexpandwillbedeletedoncethecontentshavebeenextracted.
Note:Usethispreferencewithcaution!Ifthearchiveorcompressedfileisdamaged,oranyerroroccursduringexpansion,thefilemaystillbedeletedandwouldthenhavetobereplacedbeforeyoucantryexpandingitagain.
Scanforvirusesusing:Expanderallowsyoutoautomaticallyscanfilesthatareextractedfromarchivesandencodedfilesforviruseswithyourvirusprotectionsoftware.ExpandersupportssomeversionsofMcAfeeVirusScan,NortonandSymantecAnti‐Viruswithpre‐definedselections.Ifyouwouldliketotryusingadifferentanti‐virusprogram,choose"Other..."fromthepop‐upmenu.
Reporterrors:ThispreferencedetermineshowStuffItExpanderwillhandleerrorsthatoccurwhilefilesarebeingexpanded.Youcanchoosetoignoreerrormessagethatoccur,tohavethemdisplayedinwindow,ortohavethemwrittentodiskinalogfile.
Note:IfGrowlisinstalled,the“inaWindow”optionissuppressedinfavoroftheGrowlnotifications.
DestinationPreferencesTheDestinationpreferencesdeterminewhereExpanderwillsavefilesthathavebeenextractedfromarchives,compressedfiles,orencodedfiles.Youcanchoosethelocationwherefilesareextracted.Thefollowingoptionsareavailable:
IntotheSameFolderastheArchive:Whenthisoptionisselected,fileswillbesavedtothesamelocationasthearchive,compressedfile,orencodedfilefromwhichtheywereexpanded.Thisisthedefaultsetting.
ByAskingforaDestination:Whenthisoptionisselected,Expanderwillpromptyoutospecifyalocationtowhichfilesshouldbeexpanded.
IntoaSpecifiedLocation:UsethisoptiontospecifyalocationtobeusedeverytimeExpanderexpandsafile.
ByMergingintoaSpecifiedLocation:Aswiththe"Intoaspecifiedlocation"option,thispreferencerequiresyoutochoosealocationontheharddrivetowhichthecontentsofthearchivewillbeexpanded."Merge"referstothebehaviorExpanderwillusewhenitattemptstoexpandafolderfromthearchivetothespecifiedlocation,onlytofindafileorfolderwiththesamenamealreadyexists.Whenmergingisnotselected,StuffItwillcreateanewcopyofthefolderwitha".1"attheendofitsname.IfMergingisenabled,StuffItwillexpandfilesintothetargetlocationcombiningthe
http://my.smithmicro.com
20
contentsoffolders.Ifthereisanamecollision(afilewiththesamenameisencountered),youwillbepromptedtoselectwhichofthetwofilesyouwouldliketopreserve.
ByMergingintoaLocationSpecifiedbytheArchive:Thisappliesthesame"merging"processasabove,butinsteadofpromptingyouforthelocationtowhichitemsshouldbeexpanded;thisoptionwillattempttoobtainalocationfromthe"Source"informationstoredbythearchive.Typically,thisMergeoptionwillonlybeusefulwhenyouareexpandingStuffItXarchivescreatedbyArchiveManager'sScheduler,ortheolderArchiveAssistant.
InadditiontotellingStuffItExpanderwheretoplaceitemsthatareexpanded,youcanspecifywhetherornotStuffItExpandershouldplaceexpandedfilesintoanewfolder.Thepreferencessetinthisdialogarenotappliedifeitherofthe"MergeFolders"featuresareenabled.
Whenthearchivecontainsmultipleitems:Thisisthedefaultoption.Whenthisoptionisselected,StuffItExpanderwillcreateasurroundingfolderwheneverthearchivecontainsmultipleitemsattheroot(first)level.Thenameofthearchivewillbeusedforthenewlycreatedfolder.
Never:StuffItExpanderwillnevercreateasurroundingfolder.
Always:StuffItExpanderwillalwayscreateasurroundingfolder.
FileMappingsIfyoupurchasedtheStuffItDeluxesuite,thispreferenceallowsyoutochoosewhetherStuffItX,StuffIt5,StuffIt,Zip,TARorRARarchiveswillbeexpandedwithStuffItExpanderoropenedinbrowse‐modeinStuffItArchiveManagerwhendouble‐clickedintheFinder.CompressedTararchivescanalsobebrowsedinStuffItArchiveManagerbyassigningbzip2,gzip,UNIXcompressandlzmaaccordingly.
OtherExpanderFeatures
GrowlNotificationsupportIfyouhavethenotificationsystemGrowlinstalledonyourmachine,Expanderwilluseittodisplayalertsandothermessages.
YoucanfindoutmoreaboutGrowlhere:http://growl.info
http://my.smithmicro.com
21
UpdatenotificationStuffItExpanderusesSparkleforversioncheckingandself‐updating.IfthereisanewversionofExpanderavailable,youwillreceiveanalert.Youcanchoose"InstallUpdate"whichwilldownloadthenewversion,quitExpander,andinstallthenewversioninitsplace;youcanchoose"RemindMeLater"whichwilldismissthedialog,butitwillreappearthenexttimeyoulaunchExpander;oryoucanchoose"SkipThisVersion"whichwilldismissthedialogandpreventitfromreappearinguntilthenextrevisionisavailable.
AppleScriptsupportYoucanautomateExpanderusingAppleScriptcommands.
ExpanderTroubleshootingDoubleclickingfilesintheFinder‐YoumayfindsomestubbornfilesthatdonotopenExpanderwhendouble‐clickedevenwhentheformatis“assigned”toExpanderintheFileMappingpreferences.YoucanforcetheassignmentbyselectingthefileintheFinderandthenselecting“GetInfo”fromtheFilemenu.Inthe“OpenWith”section,chooseStuffItExpanderasthepreferredapplication.Onceselected,clickthe“ChangeAll…”button.
Conversely,ifyouwouldprefertouseadifferentprogramwhenyoudouble‐clickaparticularfileformat,selectthefileintheFinderandthenselect“GetInfo”fromtheFilemenu.Inthe“OpenWith”section,chooseyourpreferredapplicationfromthelistorselect“Other…”atthebottomofthemenu.Onceselected,clickthe“ChangeAll…”button.
NoDragWindow–Expander“remembers”thestateoftheDragWindowwhentheapplicationwaslastclosed.IfyouclosetheDragWindow,thenquittheapplication,thenexttimeyoulaunchExpander,theDragWindowwillbehidden.ToseetheDragWindowagain,justlaunchExpanderandselect“StuffItExpander”fromtheWindowmenu.
ExpansionErrors:Sometimesfilesfailtoexpand.EitherStuffItExpanderlaunches,thenimmediatelyquitsasifnothinghappened,orthereisanerrorsimilartooneofthefollowing:"Error‐39UnexpectedEndofFile...","Thisisnotacompletefile...","Thisfileisnotintherightformat..."
Somepossibleproblemsandsolutions:
DiskProblems:Makesureyoursystemishealthy.Diskerrorsandincorrectpermissionscancauseproblemsreadingandwritingfiles.Aspartofyourregularperiodicsystemmaintenance,youshouldcheckyourdiskforerrorsandincorrectpermissions.
http://my.smithmicro.com
22
DamagedFiles:IfdownloadedfromtheInternet,itispossiblethatthefilewasdamagedwhenposted,ordamagedwhendownloaded.Itisalsopossiblethatthedownloaddidnotcompletesuccessfully.Ifyoucan,checkthesizeoftheoriginalpostedfileinbytes(sometimesreferredtoasthe"bytecount")andcomparethattothefileyoudownloaded.Iftheydonotmatch,thenyourdownloadedfileisprobablyincompleteordamaged.Trydownloadingthefileagain,perhapschoosingadifferenttimeofdayor,ifavailable,adifferentdownloadsite(or"mirrorsite").ProblemsontheInternettendtobeintermittentandspecifictocertainregionsoftheNetitself.Beforere‐downloadingyoumaywanttotryemptyingyouWebbrowser'scachetomakesureyouaregettinganewcopyofthefile.
IncorrectFormat:IfStuffItExpandergivesanmessagethatsaysthefileisnotintherightformat,thismayindicatethefileisdamagedanditisworthtryingthesuggestionsabove.However,itmayalsomeanthefilewascompressed,encrypted,orencodedinanunusualformatthatStuffItExpanderdoesnotrecognize.Lookattheextension(thelastfewlettersofthefilename)andcomparethattothelistofformatssupportedbyExpander.Iftheextensionisnotinthelist,seeifyoucanfindoutwhattheformatis.Ifyouthinkit'sapackagingformatthatStuffItExpandershouldsupport,thenletusknow...Newformatsandvariationsarebeingcreatedallthetime.
Thefileisalreadyexpanded:Thefilemayalreadybeexpandedbutyourmachinemaynothaveanapplicationprogramthatcanopenoreditthefile.Youmayneedtohaveinformationfromthepartythatprovidedthefiletoknowhowtouseit.Ifyoudonothavetheappropriateapplicationyouwillneedtoobtainitbysearchingtheweboralocalsoftwarestore.
Youcantrydouble‐clickingtheexpandedfile.Ifthatdoesn'thelp,youcantryopeningitbydragginganddroppingontotheiconsofapplicationsthatyoudohaveinstalled.Ifyoubelieveitisapicture,youcouldtrydraggingitontoyourWebbrowser'siconorapictureviewer.Ifit'sawordprocessingdocument,youcouldtryyourwordprocessor'sicon.
http://my.smithmicro.com
23
DropStuff‐GettingStartedDropStuffisthecompaniontoStuffItExpanderandworksusingthesameDragandDropmethod.ItallowsyoutocreateTar,ZipandStuffItXarchives–includingZipandStuffItXarchivesprotectedwithencryption.Also,DropStuffcancompressfilesandautomaticallyburnthemtoCD/DVD
oruploadthemtoeitheranFTPserveroryourMobileMeiDisk.
InstallationIfyou’vedownloadedStuffItStandard,dragtheStuffItfolderfromthedownloadeddisktoyourApplicationsfolder.
Tip:StuffItStandardusers,youcanaddDropStufftoyourDockforconvenientaccess.JustopentheStuffItfolderanddragtheDropStuffapplicationtoyourDock.
Note:OnesideoftheDockisforapplications;theotherisforfilesandfolders.
IfyouareaStuffItDeluxeuser,theinstallerhasputaStuffItfolderintoyourApplicationsfolderthatincludesDropStuffandalsoautomaticallyaddedDropStufftoyourDock.
Note:IfyouhaveolderversionsormultiplecopiesofDropStuffyoushouldremovetheothercopies.
CreatingArchivesbyDragandDroptoApplicationIcon/DockIconSelectfilesandfoldersintheFinderanddragthemtoDropStuff’sapplicationorDockiconandDropStuffwilllaunch,createanarchiveofthefilesandquit.Bydefault,DropStuffwillcreateStuffItXarchives.
Tip:DropStuffalsofeaturesanew“OneTime”optionsdialogthatallowsyoutosetthemostcommoncompressionoptionson‐the‐flysothattheyonlyapplytothecurrenttask.ThesesettingstemporarilyoverrideDropStuff’sdefaultsettings.
Touse“OneTime”options,holddownthe“Option”keywhiledraggingfilesontotheDropStuffapplicationorDockicon.
CreatingArchivesbyDragandDroptotheDragWindow WhenyoulaunchDropStuff,aDragWindowwillappearwithfiveDropTargets.Youcandragfilesontothemain(large)DropTargettocreatethedefaultStuffItXarchives.
http://my.smithmicro.com
24
Tip:ThesmallerDropTargetsareconfiguredtocreateZipandTararchivesandStuffItXarchiveswithdifferentattributes.EachDropTargetcreatesadifferenttypeofarchive.
You’vegotabasicunderstandingofDropStuffandcannowcreatearchives.ReadAppendixC:CreatingArchivesforinformationaboutchoosingtherightformatandotheroptions.ContinuereadingtherestofthissectionwhenyouarereadytofindouthowtocustomizeDropStuffforyourownneedswiththenewProfilesfeatureandtolearnaboutDropStuff’sotherAdvancedFeatures.
AnoteaboutStuffItStandard’sPremiumfeaturesUnregistered,DropStuffwillrunwithallfeaturesenabledfora30daytrialperiod.Afterthetrialperiodthesefeatureswillbecomedisabled:
• CD/DVDBurning• FTP/MobileMeiDiskuploading• Segmenting• Encryption
PurchasingaLicenseYoucanpurchaseaSoftwareLicenseforStuffItStandardfromouronlinestorehere:
http://my.smithmicro.com/store/index.html
Whenyouentertheserialnumberyoureceive,thePremiumfeatureswillberestored.
UpgradingfromStuffItStandardtoStuffItDeluxeStuffItStandardincludesonlyDropStuff,onceyou’vecreatedanarchive,youcan’tmodifyit.TheStuffItDeluxesuiteallowsyoutobrowsethecontentsofarchivesandselectivelyextractitems.Youcanadd,delete,andrenameitemsinexistingarchives.WithDeluxeyoucanschedulecompressedbackups,searchforfilesstoredinarchives,previewimagesstoredinarchives,andautomateyourworkflowwithseveralscriptingoptions.Findoutmorehere:
http://my.smithmicro.com/mac/stuffitdeluxe/index.html
http://my.smithmicro.com
25
DropStuff‐AdvancedFeaturesDropStuffisnowcompletelycustomizable!
WhenyoulaunchDropStuff,itsmainwindowappearsshowingonelargeDropTargetandfoursmallerDropTargets.InDropStuff’sProfilesSetupwindowyoucancreateuniqueCompressionandDestinationsettings,savethemtoa“Profile”andassignthemtoanyoftheDropTargetsinthemainwindow.ThelargerDropTargetisDropStuff’sdefaultanddetermineshowtheprogramwillfunctionwhenyoudragfilestoitsDockorApplicationicon.DraggingfilesandfolderstothatDropTargetwillcreateanarchiveusingthesettingsfromProfileyouspecified.YoucanalsosaveaProfileasaDropletintheFinder.
Tip:WhileDropStuff’smainwindowislimitedtofiveProfiles,youcanmakeasmanyuniqueDropletsasyouwish.Also,youcanuseDropletsevenifDropStuffisnotalreadyrunning.
Note:DropletsarenotcontinuouslyconnectedtotheProfilethatcreatedthem.IfyouchangetheProfilesettingsandwantthosesettingsappliedtoaDropletyouwillneedtosaveanewDropletfromthatProfile.
BecauseDropletsareindependent,theyareunaffectedbychangesordeletionoftheProfilesfromwhencetheycame.
SettingUpDropStuffProfilesInDropStuff’sProfilesSetupwindowyoucancreatenewProfilesanddefinetheseattributes:
• ArchiveSettings:ChoosebetweenStuffItX,ZipandTarformats.Thenchooseoptionsfortheparticularformatlikeencryption.
• DestinationSettings:Choosebetweenlocaldirectories,burningtoCD/DVD,FTPservers,MobileMeiDisk
• EncodingSettings:Automaticallypost‐encodethearchiveforpostingtotheInternet
• OtherOptions:Variousgeneralsettings.
http://my.smithmicro.com
26
TherearetwooptionsforusingthisProfile:
• SaveittotheDesktop(oranywhereonyourdisk)asaDropletbyclickingthe“CreateDroplet”button.
TouseaDroplet,justdragfilesand/orfolderstotheDropletintheFinder.
Tip:DragyourDropletstoyourDockforconvenientaccess.
• AssigntheProfiletooneofthefiveDropTargetareasinDropStuff’sDragWindowbydraggingtheProfilenametotheDropTarget.
Note:thecenterDropTargetisthedefaultProfilethatDropStuffwilluseinminimizedmode,andwhenfilesaredroppedontheapplicationorDockicon.
Touseit,dragfilesand/orfolderstotheDropTargetonDropStuff’smainwindow.
Example1:CreateEncryptedStuffItXarchivesandburntoCD/DVD1. Select“Profiles”fromDropStuff’sWindowmenu,ordouble‐clickon
anyoftheDropTargetsinDropStuff’sDragWindow,toopentheProfilesSetupwindow
2. Clickthe“+”tocreateanewProfile3. Itwillappearalphabetizedintheprofileslist.ThedefaultEnglishtitle
is"NewProfile."4. Double‐clickthenameandchangeittosomethingmoreinformative
like“EncryptandBurn”5. Select“StuffIt”fromtheArchiveTypepop‐upmenu(Notethattheicon
changeswhenyouchangearchiveformat)6. Enablethe“Encryptarchiveswithpassphrase”option7. Leave“Createsearchableindexarchive”enabled(thisfeatureallows
StuffItDeluxeuserstolocatefilesinarchivesstoredoffline)8. Scrolldowntheoptionslistto“Destination”andchooseCD/DVDfrom
thepop‐upmenu.
Optionallyspecifyadirectorytotemporarilystorethecompressedfilesbeforeitisburnedtodisk.
http://my.smithmicro.com
27
CreatemoreProfilestomeetyourneeds.Thepossibilitiesareenormous!
DropStuffAdvancedFeatures
StuffwithFiltersYoucanusethe"StuffwithFilters"menucommandtocreateanarchive,fromasourcefolder,thatonlycontainsthoseitemsthatmatchthecustomsearchcriteriayouspecify.
Whenyouchoose"StuffwithFilters"fromthefilemenu,youwillfirstbeaskedtochoosethesourcefolderfromwhichyouwishtocreateanarchive.Afteryouhaveselectedthefolder,youwillnextbepresentedwitha"Find..."dialogthatallowsyoutospecifywhichfilesinthefolderyouwishtoaddtothearchive.
Whiletheentirefolderhierarchywillberecreatedwithinthearchive,onlyfilesthatmatchthesearchcriteriayouspecifyinthisdialogwillbeaddedtothearchive.
AdvancedFeaturesfortheStuffItDeluxeuser
StuffItIndexArchivesDropStuffwillcreatesmallStuffItIndexproxyfilesinyourhomefolderwheneveryoumakeStuffItXarchives.WiththetoolsavailableinStuffItDeluxe,theseIndexArchivescanbesearched,andopenedjustliketheStuffItXarchivetheyarepaired
Example2:CreateZiparchivesintendedforWindowsusersanduploadtoFTPsite.1. Select“Profiles”fromDropStuff’sWindowmenutoopentheProfilesSetup
window2. Clickthe“+”tocreateanewProfile3. Itwillappearalphabetizedintheprofileslist.ThedefaultEnglishtitleis
"NewProfile."4. Double‐clickthenameandchangeittosomethingmoreinformativelike
“ZipandFTP”5. Select“Zip”fromtheArchiveTypepop‐upmenu6. Disablethe“PreserveMacintoshContent”option(disablingthisfeature
preventsWindowsusersfromreceivingunneededMac‐specificcontent.)7. Scrolldowntheoptionslistto“Destination”andchooseFTPfromthepop‐
upmenu.8. EntertheFTPserverinformation.9. Optionallyspecifyadirectorytotemporarilystorethecompressedfiles
beforeitisuploadedtotheFTPserver.10. AsinExample1above,createaDroplet,and/orassigntheProfiletoa
targetonDropStuff’smainwindow.
http://my.smithmicro.com
28
with,eveniftheStuffItXarchiveisstoredofflineonCD/DVD,orpostedtotheInternet.YoucanreadmoreintheStuffItIndexArchivessectionofthemanual.
OtherDropStuffFeatures
GrowlNotificationsupportIfyouhavethenotificationsystemGrowlinstalledonyourmachine,DropStuffwilluseittodisplayalertsandothermessages.
YoucanfindoutmoreaboutGrowlhere:http://growl.info
VersionCheckingDropStuffwillcontacttheSmithMicroserveronlaunchtoseeifthereisanewerversionavailable.Ifyouwouldliketodisablethis,uncheckthe“AllowVersionCheck”optionfromthe“DropStuff”menu.
AppleScriptsupportYoucanautomateDropStuffusingAppleScriptcommands.
IfyouhaveStuffItStandard,youcanstopreadingnow.TherestofthismanualexplainshowtousethepowerfultoolsincludedintheStuffItDeluxesuite.Orreadonandseewhatyouaremissing…
http://my.smithmicro.com
29
TheStuffItDeluxeSuiteInadditiontoStuffItExpanderandDropStuffdescribedabove,StuffitDeluxeincludesmanymoretoolsforworkingwitharchives.Thissectiondescribestheadditionalcomponents.
http://my.smithmicro.com
30
TheStuffItQuickLookpluginIntroducedinMacOS10.5,QuickLookletsyou"Lookbeforeyoulaunch".Youcanpeekintomanytypesoffileswithoutlaunchinganyprogram.WiththeStuffItQuickLookplugin,youcan"Lookbeforeyouexpand".
MoreinfoonQuickLookcanbefoundhere:
http://www.apple.com/macosx/features/quicklook.html
QuickLookisbuiltrightintotheFinder.TopeekinsideanarchivewithQuickLook,selectthearchiveintheFinder,thenhittheSpaceBar,orCmd+Y.Awindowwillappeardisplayingthecontentsofthearchivehierarchically.
Youcanoptionallytogglewhetherinvisiblefilesaredisplayedornot.
Ifyou’dliketoopenthearchive,justdouble‐clickanywhereinthewindow.
Tip:QuickLookjusttellsthesystemtoopenthecurrentlyselectedfile.IfStuffItExpanderisassociatedwiththistypeoffile,thenitwilllaunchandexpandtheentirearchive.IfinsteadArchiveManager“owns”thisfiletype,thenitwilllaunchandopenthearchiveinbrowse‐modesoyoucandomorewiththearchivecontents.YoucanchangethisbehaviorbyadjustingtheFileMappingsinStuffItExpander’sPreferences.
TheCoolestThingQuickLookisintegratedintootherAppleapplicationslikeMailandTimeMachine.Thismeansthatifsomeonesendsyouacompressedemailattachment,youcanpreviewthecontentsofthearchiverightinMailwithouthavingtosaveitfirst,andthenopenit.Likewise,ifyouareusingTimeMachinetodoregularincrementalbackupsandhavearchivesonyourmachine,youcanpreviewthecontentsofarchivesrightintheTimeMachinebrowser.
Tip:Ineithercase,ifyoudouble‐clickanywhereintheQuickLookwindow,itwilltellthesystemtoopenthefile.Youcansetthebehaviorasdescribedabove.
http://my.smithmicro.com
31
MagicMenuandtheStuffItContextualMenu‐GettingStarted
TheMagicMenu™AfterinstallationMagicMenuisaddedtoyourloginitemsandislaunchedautomatically.Whenyoulogintoyouraccount,anewiconwillappearinyourFindermenubar.ThisistheMagicMenu.
ItprovidesquickaccesstomanyofStuffIt’sfeatureswithouthavingtolaunchanyapplications.
ExpandingwithMagicMenuToexpandacompressedfile,selectitintheFinder,thenclickontheMagicMenuandchoose“Unstuff”or“Expand”.
Note:TheitemsthatappearintheMagicMenuarecontextualbasedonwhatisselectedintheFinder.IfyouselectaDiskImageforexample,thecommand“Mount”willappearinthemenu.Ifyouselectanarchive,“Expand”or“Unstuff”willappearinthemenu.
CreatingArchiveswithMagicMenuCompressingfileswithMagicMenuisassimpleasselectingthemintheFinderandthenclickingontheMagicMenuandselectingthedesiredarchiveformat.YoucancreateStuffItX,ZipandTarformatswithavarietyofoptionsincludingencryptionandencoding.
OlderformatscanbecreatedusingMagicMenu’s“Legacy”commands.
MailOperationsMagicMenu’sMailsub‐menuallowsyoutocreateanarchiveandsenditviaE‐mailinasinglestep.Justselecttheitem(s)youwanttosend,gototheMagicMenuandchoose(forexample)"Stuff&Mail".TheMailsub‐menulistsavarietyofarchiving
TheStuffItContextualMenuAfteryouinstallStuffItDeluxe,youshouldseeanew“StuffIt”MenuappearintheFinder’scontextualmenu.(User’sofMacOS10.5“Leopard”willfindnon‐Applecontextualmenusunder“More”).Toaccessthecontextualmenu,holddowntheControl(Ctrl)keywhileclickingafileintheFinder.Ifyouhaveamulti‐buttonmouse,youcanalsoright‐clicktoactivatethecontextualmenu.
Exceptforcommandkeys,theStuffItContextualMenuprovidesthesamefunctionsastheMagicMenu.Fortherestofthisguide,wewillrefertoMagicMenubutnotethatthesefeaturesalsoapplytotheStuffItContextualMenu.
http://my.smithmicro.com
32
andcompressionoptionssoyoucancompressandmailanarchivecreatedinmostoftheformatsthataresupportedbyStuffIt.
Tip:Youcanalsochoosethesub‐menuitem"Mail"whichallowsyoutosendtheselecteditem(s)withoutarchiving.
BrowsingArchivesviaMagicMenuUsingMagicMenu,youcan‘handoff’archivestootherStuffIttoolsforbrowsing.
TosendthearchivetoArchiveManagerselectanarchiveintheFinder,andchoose“BrowseinArchiveManager”fromtheMagicMenu.
IfyouhaveMacFUSEinstalled(seebelow),youcanusetheStuffItpluginforMacFUSE.JustselectthearchiveintheFinder,thenselect“MountArchive”fromtheMagicMenu.MacFUSEwilllookatthearchive’sstructure,andthenmountitontheDesktoplikeadisk.
LaunchingStuffItApplicationsviatheMagicMenuYoucanquicklylaunchanyoftheStuffItapplicationswithouthavingtonavigatetotheApplicationsandthenStuffItfolders.Justselect“Launch”andthenthedesiredStuffItapplicationfromthesub‐menu.
You’vegotabasicunderstandingofMagicMenuandtheStuffItContextualMenu.ContinuereadingtherestofthissectionifyouwouldliketolearnaboutAdvancedFeatures.
http://my.smithmicro.com
33
MagicMenuandtheStuffItContextualMenu–AdvancedFeatures
GrowlIfyouhavethenotificationsystemGrowlinstalledonyourMac,MagicMenu/StuffItContextualMenuwilluseittodisplayalertsandothermessages.
CommandKeyShortcutsWhenMagicMenuisloaded,youcanaccessStuffItfunctionsintheFinderusingCommand‐keyshortcuts.
Toexpandafile,selectitintheFinderandhitthe“Command+U”keystoexecutetheUnstuff/Expandcommand.
UseCommand+StostufffilesandfoldersthathavebeenselectedintheFinder.
YoucanalsouseCommand+Option+1tocreateStuffItXarchives,Command+Option+2tocreateolderStuffIt5archives,andCommand+Option+3tocreateZiparchives.
Tip:YoucandisabletheCommandKeyshortcutsintheMagicMenuPreferencesundertheMenuOptionstab.
MenuItems‐TheCompleteListSomeoftheitemsintheMagicMenuareconditionalandonlyappearwhenyouselectspecifictypesoffiles.BelowisthecompletelistofcommandsthatcanappearintheMagicMenuandStuffItContextualMenu:
Stuff:TheStuffcommandwillcreateaStuffItXarchivethatcontainstheitemsthatarecurrentlyselectedintheFinder.
Unstuff/Expand:Iftheselectedfileisanarchive,compressed,orencoded,thisoptionwilldecompressit.
CreateIndex:IftheselectedfileisaStuffItXarchive,thiscommandwillcreateaStuffItIndexarchivesothatthemainarchivecontentscanbesearchedevenifthearchiveisstoredoffline(eg:onaCDorDVD).
BrowseinArchiveManager:Iftheselectedfilesupportsbrowsing,thiscommandwillopenthefileinanArchiveManagerbrowsewindow.
MountArchive:ForLeopardusers,ifMacFUSEisinstalledandtheselectedfilesupportsbrowsing,thiscommandmountsthearchiveintheFinderasavolume.
http://my.smithmicro.com
34
Archive:TheArchivesub‐menuprovidesyouwiththeoptiontocreatearchivesfromtheitemscurrentlyselectedintheFinder,inawidevarietyofformats.YoucancreateStuffItX,Zip,andTararchivesusingtheArchivecommand.Archivespreservehierarchicalfolderstructure.Youcanalsochoosetofurthercompressorencodethesearchivessothatyouendupwith,forexample,aGzipcompressedTARarchive.
Compress:TheCompresssub‐menuallowsyoutocompresssinglefilesselectedintheFinderusingGzip,Bzip2,andUnixCompresscompression.Compressionoperationscanonlybeperformedonindividualfiles,notfoldersorselectionsofmultiplefiles.
Encode:TheEncodesub‐menuallowsyoutoencodesinglefilesselectedintheFinderusingMacBinary,BinHex,AppleSingle,andUUEncodeformats.Encodingoperationscanonlybeperformedonindividualfiles,notonfolders.Afoldermustbearchivedintoasinglefilebeforeitcanbeencoded.
Join:Ifpart1ofanolderStuffIt5segmentisselected,thiscommandwilljointhesegmentstogetherintoasinglefileagain(providedallthesegmentsarepresentinthesamelocation).
Note:Forallothersegmenttypes(StuffItX,Zip,RAR),justlocatethefirstsegmentandusetheUnstuff/Expandcommand.
Legacy:TheLegacysub‐menuallowsyoutocompressfilesintoolderandlesscommonformats.
Stuff(.sit):ThisoptioncreatesarchivesintheolderStuffIt5format.
MakeSelfExtracting:TheMakeSelf‐ExtractingmenuallowsyoutocompressfilesintoaStuffIt5(.sit)archiveandmakethatarchiveself‐extractingforeitherClassicMacintoshOS(.sea)orWindows(.exe).
LHa:ThisoptioncreatesLHaarchives.
Segment:UsetheSegmentmenuoptiontodividelargefilesintosmallerpieces.ThesizeofthesegmentsthatwillbecreatedcanbesetintheStuffItMenuPreferencesdialog.
Mail:TheMailsub‐menuattachesfilestoanoutgoingemailmessageinyourpreferredemailclient,optionallycompressingthem.
Verify:Iftheselectedfileiscompressed,thiscommandchecksthefile,andnotifiesifthereareanyproblems.
Launch:AllowsquicklaunchingofStuffItapplications.
http://my.smithmicro.com
35
Preferences:OpenstheStuffItMenuPreferencesdialog.
Quit:QuitstheMagicMenuprogram.Itcanberelaunchedbydouble‐clickingtheMagicMenuapplicationlocatedintheStuffItfolderintheApplicationsfolder.Ifyourestart,orlogout/in,MagicMenuwillautomaticallyreload.
DisablingMenuItemsYoucandisablenearlyanyofthemenuitemsbyuncheckingthemintheMagicMenuPreferencesundertheMenuOptionstab.
PreventingMagicMenufromAuto‐loadingatLoginTopreventMagicMenufromloadingwhenthesystemstarts,followthesesteps:
1. FromtheAppleMenu,choose"SystemPreferences"
2. Click"Accounts"toopenthatcontrolpanel.
3. Clickyouruser’snameintheAccountscontrolpanel.Youmayneedtoauthenticatetomakechanges.
4. Clickthe"LoginItems"tab.
5. Selectthe"MagicMenu"itemfromthelistthatappears.
6. Clickthe"‐"buttontoremoveMagicMenu.MagicMenuwillnolongerlaunchwhenyourcomputerstartsup.
YouwillstillbeabletoaccessStuffItmenufeaturesviatheStuffItContextualMenu,butwillnotbeabletousetheCommandKeyshortcuts.
ChangingMagicMenu’sPreferencesToopenMagicMenupreferences,choose“Preferences…”fromtheMagicMenu.
ExpansionPreferencesTheExpandingPreferencesareusedtodeterminehowMagicMenugoesaboutthetaskofexpandinganarchiveorencodedfile.
Continuetoexpandifpossible:Thispreference,whenenabled,causesMagicMenutoscantheexpandedoutputtoseeifitcanbefurtherexpanded.Forexample,expandingaBinHexencodedStuffItarchive(foo.sit.hqx),MagicMenuwillstarttoexpandthearchive“foo.sit”assoonasithasremovedtheBinHex(.hqx)encoding.
Note:Archives,compressed,andencodedfilescontainedwithinsubfoldersinthearchivemustbeseparatelyexpanded.
http://my.smithmicro.com
36
Setexecutepermissionsbydefault:ThispreferencedetermineswhetherMagicMenushouldsettheexecutefilepermissionattributeonitemsexpandedfromarchivesthatdonottypicallystoreUNIXfilepermissions,suchasZip(.zip)andtheolderStuffIt(.sit).Ifyouun‐checkthisbox,OSXapplicationsexpandedfromsucharchivesmaynotruncorrectly.
Note:StuffItXarchives(.sitx)aredesignedtopreserveUNIXpermissionsandignorethissetting.
Mountdiskimages:Whenthisoptionisenabled,MagicMenuwillattempttomountdiskimagefiles(resultingintheappearanceofa"virtualdisk").Apple'sDiskImageMounterisusedtomounttheimages.
Deleteafterexpanding:Whenenabled,thearchive,compressed,orencodedfilesexpandedbyMagicMenuwillbedeletedoncethecontentshavebeenextracted.
Note:Usethispreferencewithcaution!Ifthearchiveorcompressedfileisdamaged,oranyerroroccursduringexpansion,thefilemaystillbedeletedandwouldthenhavetobereplacedbeforeyoucantryexpandingitagain.
Scanforvirusesusing:MagicMenuallowsyoutoautomaticallyscanfilesthatareextractedfromarchivesandencodedfilesforviruseswithyourvirusprotectionsoftware.MagicMenusupportssomeversionsofMcAfeeVirusScan,NortonandSymantecAnti‐Viruswithpre‐definedselections.Ifyouwouldliketotryusingadifferentanti‐virusprogram,choose"Other..."fromthepop‐upmenu.
CompressionPreferencesTheCompressionpagecontainssettingsthatrelatetohowMagicMenucreatesarchives.TheCompressionpagecontainsamulti‐tabbedgroupboxthatcontainssettingsthatarespecifictoparticularfileformats,andalsocontainsitemsthatareappliedtoallfileformats.
RefertoAppendixD:FormatCompressionOptionsfordescriptionsoftheoptionsofferedforeachformat.
ThefollowingsettingsatthebottomoftheCompressionPreferenceswindowapplytothecreationofallarchiveformats:
Mailusing:Thispop‐upmenuallowsyoutoselectthemailclientthatwillbeusedwhenusingtheStuffandMailcommand.AllthemailclientsthatsupporttheMagicMenumailcommandsarelistedinthispop‐upmenu.
http://my.smithmicro.com
37
IgnoreSpecialFinderFiles:Whenthisoptionisset,MagicMenuwillnotaddFinderfiles(suchas.DS_StoreorolderDesktopDatabasefiles)toanarchive.
CreateIndividualArchives:Whenthisoptionisset,compressingmultipleitemswithMagicMenuwillresultineachitembeingcompressedinitsownindividualarchive.
DestinationPreferencesTheDestinationpreferencesdeterminewhereMagicMenuwillsavefilesthathavebeencompressedaswellasthosethathavebeenextractedfromarchives,compressedfiles,orencodedfiles.
CompressionDestinationYoucanchoosethelocationwherenewarchivesarecreated.Thefollowingoptionsareavailable:
IntotheSameFolderastheSourceFiles:Whenthisoptionisused,archiveswillbesavedtothesamelocationastheoriginalselectedfiles.Thisisthedefaultsetting.
ByAskingforaDestination:Whenthisoptionisselected,MagicMenuwillpromptyoutospecifyalocationtowhichfilesshouldbecreated.
IntoaSpecifiedLocation:UsethisoptiontospecifyalocationtobeusedeverytimeMagicMenucreatesafile.
ExpansionDestinationYoucanchoosethelocationwherefilesareextracted.Thefollowingoptionsareavailable:
IntotheSameFolderastheArchive:Whenthisoptionisselected,fileswillbesavedtothesamelocationasthearchive,compressedfile,orencodedfilefromwhichtheywereexpanded.Thisisthedefaultsetting.
ByAskingforaDestination:Whenthisoptionisselected,MagicMenuwillpromptyoutospecifyalocationtowhichfilesshouldbeexpanded.
IntoaSpecifiedLocation:UsethisoptiontospecifyalocationtobeusedeverytimeMagicMenuexpands/unstuffsafile.
InadditiontotellingMagicMenuwheretoplaceitemsthatareexpanded,youcanspecifywhetherornotMagicMenushouldplaceexpandedfilesintoanewfolder.
Whenthearchivecontainsmultipleitems:Thisisthedefaultoption.Whenthisoptionisselected,MagicMenuwillcreateasurroundingfolder
http://my.smithmicro.com
38
wheneverthearchivecontainsmultipleitemsattheroot(first)level.Thenameofthearchivewillbeusedforthenewlycreatedfolder.
Never:MagicMenuwillnevercreateasurroundingfolder.
Always:MagicMenuwillalwayscreateasurroundingfolder.
OtherMagicMenuFeatures
GrowlNotificationsupportIfyouhavethenotificationsystemGrowlinstalledonyourmachine,MagicMenuwilluseittodisplayalertsandothermessages.
YoucanfindoutmoreaboutGrowlhere:http://growl.info
http://my.smithmicro.com
39
TheStuffItPluginforMacFUSEMacFUSEisakernelextensionfromGoogleforOSXthatallowsforeignfilesystemstobemountedintheFinderjustlikedisks.AStuffItpluginforMacFUSEisincludedwithStuffItDeluxeandwillloadifMacFUSEisavailableonyoursystem.
Note:EventhoughthereareversionsofMacFUSEforbothMacOS10.4and10.5,only10.5issupported.
YoucandownloadMacFUSEfromhere:
http://code.google.com/p/MacFUSE/
TomountanarchivewiththeMacFUSEplugin,justselectitintheFinder,thenselect“MountArchive”fromtheMagicMenuortheStuffItContextualMenu.MacFUSEwilllookatthearchive’sstructure,andthenmountitontheDesktoplikeadisk.
Note:foralistofbrowsablearchivetypes,pleaseconsultAppendixA.
Oncemounted,usingthatfilesystemisjustlikeusinganyotherdisk.YoucannavigateintofoldersandyoucancopyfilesoutbydraggingthemtotheDesktop.
http://my.smithmicro.com
40
Whenyouarefinishedwiththearchive,youcanejectitbydraggingitsdiskicontothetrash.
TroubleshootingtheMacFUSEPluginIfarchivesdon’tappeartomount,itmaybethatyouneedtochangeyourFinderpreferences.IntheFinder‐>Preferences‐>Generaltabmakesurethatthe“ConnectedServers”optionisenabledunderthe“ShowtheseitemsontheDesktop”setting.
Note:ThereisabuiltinoneminutetimeouttopreventoperationsthattakealongtimefromhangingtheFinder.Ifthetimeoutexpires,MacFUSEwilldisconnectthefilesystem.ThearchivewillstillbevisibleintheFinderasamountedvolume,butitwon'tbeonline.Theonlythingyoucandoatthatpointisejectthedisk.Thismightoccurifyouareonaveryslowmachine,workingwithaverylargearchive,orworkingwithanarchivewithverymanyitemsinit.
http://my.smithmicro.com
41
StuffItSpotlightPluginSpotlightisasearchtechnologybuiltintoMacOS10.4and10.5.Spotlightbuildsandconstantlyupdatesanindexofallthefiles
locatedonyourharddrive.WhenStuffItDeluxeisinstalled,Spotlightisabletoextenditsindexcapabilitiestoincludethenamesoffileslocatedinanysupportedarchives.WhenyouuseSpotlighttorunasearch,ifamatchingfileislocatedinanarchive,thatarchiveisreturnedaspartofSpotlight’ssearchresults.
TroubleshootingtheStuffItSpotlightPluginIfarchivesdon’tappearinyoursearchresultswhenyouexpecttheyshould,youcanquicklyseeifaparticulararchiveinquestionhasbeenindexedbySpotlight.
• SelectthearchiveintheFinderandusetheGetInfocommand.• IntheMoreInfosectionoftheGetInfowindowthereshouldbeinformation
aboutthearchiveanditscontents.
Ifyoudon’tseethisitmaybethatSpotlighthasstoppedindexingyourdrive.Checkthefollowing:
• IntheSystemPreferences…‐>Spotlight‐>Privacytabseeifyourharddiskislisted.Ifitis,removeitandSpotlightshouldimmediatelystartindexingyourdrive(bepatient,thismaytakesometime).
Tip:YoucanresetSpotlight’sdatabasebyaddingyourdrivestothePrivacylist,thenremovingthemagain.
StuffItIndexArchivesTheStuffItpluginforSpotlighttoallowssearchingforfilesthathavebeenstoredinanarchive.IntroducedinStuffIt11forMacintosh,StuffItIndexArchivesmakethisfeatureevenmoreusefulbyaddingtheabilitytosearcharchivesevenwhentheyhavebeenmovedtoCDs,DVDs,orother"offline"locations.AnIndexArchiveisalocalproxyforanarchive.
http://my.smithmicro.com
42
CreatedatthesametimeasaregularStuffItXarchive,anIndexArchivecontainsacompletelistofallthefilesstoredinits"paired"StuffItXfile.IndexArchivesarefullysearchable,andcanbeopenedandbrowsedusingtheArchiveManagerapplication.Becausetheycontaincataloginformation,butnodata,theyareafractionofthesizeofaregularStuffItXarchive,IndexArchivescanbestoredonyourcomputerwhilethefullversionofthearchiveismovedtoaCDorDVDtosaveyouspace.StuffItStandardusersshouldconsiderupgradingtotheStuffItDeluxesuitetotakefulladvantageofthesefeatures.
UsingIndexArchivesIndexArchivescanbecreatedusingArchiveManager,MagicMenu/StuffItContextualMenu,andDropStuff.ThecreationofIndexArchivescanbeturnedandonandoffinDropStuff,MagicMenuandArchiveManagerbutisalwaysenabledinArchiveManager'sSchedulerfeature.
ToenablethecreationofIndexArchivesinDropStuff,simplycheckthe"CreateIndexArchive"boxinthemainDropStuffwindow.TocreateIndexArchiveswithArchiveManagerandMagicMenu/StuffItContextualMenu,openthepreferencesdialogandcheckthe"CreateIndexArchives"optiononthe"StuffIt"tabofthe"Compression"optionspage.
YoucanalsocreateIndexArchivesofexistingStuffItXarchives.JustselectthearchiveintheFinder,thenuseMagicMenu/StuffItContextualMenu's"CreateIndex"option.
StuffItIndexArchivesarestoredinacommonlocation,you'llfindthesefilesinthe‘StuffIt’folder,locatedinyourhomefolder,onyourMac’sharddrive.StuffItXIndexArchivesaredifferentiatedbyayellowiconanda.sidxfileextension.
YoucanviewanyIndexArchivesthathavebeencreatedonyourcomputerbylaunchingtheArchiveManagerapplication,andclickingonthe"StuffItXIndexes"collection.Ifyoudoubleclickanyofthelistedindexfiles,theywillbeopenedupinbrowsemodeinanArchiveManagerwindow.RememberthataStuffItXIndexArchiveisnotanarchive,butisratheraproxyofanarchive.WhenbrowsinganIndexArchiveyoucanviewthefilesandfolderhierarchyoftheparentarchive,butyoucannotdirectlyopenanyofthefilesthatarelisted.
http://my.smithmicro.com
43
TheprimarylimitationofanIndexArchiveisthatitwon'tallowyoutoopenorexpandafiledirectly.Itspurposeittoserveasapointerthatletsyouknowinwhicharchiveaparticularfileisstored.Theoriginalarchivemustbeopenedbeforeyoucanexpandanyofthefilesitcontains.IfyoutrytoextractfilesfromanIndexArchiveyouwillbepromptedfortheoriginal.
http://my.smithmicro.com
44
StuffItArchiveManager‐GettingStartedStuffIt®ArchiveManager™isthecommandcenterforworkingwithcompressedandencodedfiles.DrivenbySpotlight’sautomaticdiskindexing,ArchiveManagerprovidesacentralplacetoseeallofthearchivesstoredonyourcomputerthatis
dynamicallyupdatedasthecontentsofyourharddrivechange.
FindingArchivesInArchiveManager’smainwindow,thereareanumberofpre‐defined“Collections”.Withasingleclick,youcanquicklyviewallarchivesofaparticularformat.Forexample,clickon“StuffItXArchives”intheCollectionslistandyouarequicklypresentedwithalistofalltheStuffItXarchivesavailablebothonyourcomputerandonanymountednetworkdrives.
Tip:YoucanfiltertheResultslistbytypingallorpartofthenameofafileintotheSearchfieldatthetopoftheMainwindow.ArchiveManagerwillupdateitslisttopresentonlythosearchivesthatmatchthesearchtermsyouspecify.
BelowthepresetCollectionsareCustomCollectionsthatyoucancreateandmodify.InStuffIt2009we’veprovidedsomesampleCustomCollections.
‐ ClickonaCollectionandArchiveManagerwilllistthesearchresultsintheResultsListwindowontheright.
‐ ClickonceonanarchiveintheResultsListandArchiveManagerwillscanitforimagesanddisplaypreviewthumbnailsinthePreviewdrawer.If
youclickonthe“Contents”tab,ArchiveManagerwillshowahierarchicallistofthearchive’scontents.
Tip:Youcanselectapreviewthumbnail,oranitemintheContentslistandchooseeither“RevealinArchive…”fromtheActionmenutoopenthearchiveandselectthatitem,or“Extract…”tounstuffitfromthearchive.
http://my.smithmicro.com
45
Double‐clickonanarchiveintheResultsListandArchiveManagerwillopenitinaBrowsewindow.
Note:IftheitemintheResultsListiscompressed,butdoesn’tsupportbrowsing,ArchiveManagerwillpromptforadestinationtoexpandthefile.Iftheitemisn’tsupportedbyArchiveManageratall,itwillattempttoopenitintheFinder.
OpeningArchivesinArchiveManagerfromtheFinderFromtheFinder,thereareseveralwaystoopenarchivesinArchiveManager.
• YoucandragarchivestotheArchiveManagerapplicationicon(whichwillbeinyourDockafterinstallation).
• YoucanselectanarchiveintheFinder,andchoose“BrowseinArchiveManager”fromtheMagicMenu.
Tip:InStuffItExpander’sFileMappingPreferencesyoucansetarchivestoautomaticallyopenwithArchiveManagerwhendouble‐clickedintheFinder.
ChangingtheContentsofanArchiveWhenanarchiveisopeninStuffItArchiveManager,itscontentsarepresentedtoyouinmuchthesamewayastheFinderpresentsfoldercontentinformation.
YoucanaddandremovefilesfromanarchiveinthesamemanneryouwouldaddandremovefilesfromafolderintheFinder.Dragfilesintothearchivewindowtoaddthemtoyourarchive;dragfilesfromthearchivewindowtotheFindertoextractthem.Youcanalsodelete,rename,moveandcopyfilesinanarchivethesameasyouwouldintheFinder.
Note:SomearchiveformatsareReadOnlyanddonotsupportmodification.ThesewillbeindicatedwithaReadOnlybadgeintheBrowsewindow.
WorkingwithCustomCollectionsInadditiontothepre‐definedcollectionsthatshipwithArchiveManager,youcanalsocreateyourowncustomcollections.Thesecustomcollectionsworkinmuchthesamewayas“SmartPlaylists”iniTunes.
Tocreateacustomcollection,startbydefiningasetofsearchcriteriasuchasthearchivetype,size,ormodificationdate.WhenArchiveManagerdisplaysyourcollection,itsearchesitsdatabaseofallaccessiblearchivesanddisplaysonlythoseitemsthatmatchthesearchcriteriayouspecify.
Here’showtocreateacustomarchivecollectionthatcontainsStuffItXarchivesmodifiedwithinthelastweek:
http://my.smithmicro.com
46
1. LaunchtheArchiveManagerapplication.2. Clickthe“+”buttoninthelowerleftcorneroftheapplicationtocreateanew
customcollection.3. Inthedropdownsheetthatresults,definethesearchcriteriayouwantto
usetocreateyourcollection.4. Inthe“Description”field,entertextthatwillhelptoremindyouofwhatthis
collectionisdesignedtodo.Forthisexample,type“NewStuffItXArchives”.5. The“SearchLocation”sectionallowsyoutospecifywhereStuffItArchive
Managerwilllookformatchingfiles.Choose“Computer”tosearchonallharddrivesaccessibletoyourcomputer.Thiswillincludeyourharddrive,anyexternalharddrivesyouhaveattachedandanymountednetworkdrives.
6. Inthe“SearchFor”section,specifythetypeofitemyouarelookingfor.Inthisexample,clickthe“Name”pop‐upmenuandchoose“Kind”.Inthepop‐upmenuthatappearstotherightofthe“Name”field,choose“Archives”and,inthenextpop‐upmenu,choose“StuffItX”.
7. Toaddanadditionalsearchparameter,clickthe“+”button.8. Clickthe“Name”pop‐upmenuandchoose“LastModified”tocreatecriteria
thatwilldisplayarchivesthathavebeenrecentlymodified.Type“7”inthetextentryfieldtodisplayonlyitemsthathavebeenmodifiedwithinthelastsevendays.
9. Click“OK”toclosethedialog.YoushouldnoticethattheArchiveManagerdialognowhasanewlistingforthecollectionyoujustcreated.Onceyouexitthedialog,ArchiveManagerwillimmediatelystartbuildingthelistofarchivesthatmatchyoursearchterms.
Note:StuffItArchiveManagerutilizesApple’sSpotlightSearchtechnology.Accordingly,anyitemsthatexistinlocationsyouhaveexcludedfromSpotlightsearcheswillnotbedisplayedCollectionsearchResults.
CreateArchivesfromCustomCollectionsArchiveManager’sCustomCollectionscancontainfilesofanytypeincludingapplications,musicandpictures.UsingStuffItArchiveManager,youcancreateacollectionthatincludesallthefilesyouneedtoworkonaparticularproject.Forexample,ifyouwerethetechnicalwriterforStuffItDeluxe,youcouldcreateacollectionthatcontainsonlyfileslocatedinthe“Documents”folderthatcontain“StuffIt”inthename.
WhenyouclickonyourCustomCollection,theresultsarepresentedintheResultsListontheright.Ifyouselectsomeoralloftheitems,youcanchoose“NewArchivefromSelection”fromtheactionmenutocreateanewarchiveoftheseitems.
TroubleshootingArchiveManagerIfarchivesdon’tappearinyourCollectionssearchresultswhenyouexpecttheyshould,followtheSpotlighttroubleshootingstepsabove.
http://my.smithmicro.com
47
ScheduledArchivingwithStuffItSchedulerStuffItArchiveManagerincludesaschedulingfeaturethatisdesignedtoprovideasimple,easytouse,personalbackupsolution.YoucanuseStuffIttoscheduleautomaticfilebackups,andyoucansavethebackuparchivesyoucreatetoCDs,DVDs,externaldrives,FTPserversandevenyourMobileMeiDisk.
GettingStartedTogetstartedwithabackuptask,launchtheArchiveManagerapplicationandthenclickthe“Scheduler”toolbarbutton.Whenyouclickthe“NewTask”buttonontheSchedulertoolbar,the“NewTask”assistantisopened.Thiswizard‐styleinterfacewillwalkyoustep‐by‐stepthroughtheprocessofnamingthebackuptask,selectingthesourcedatatobackup,selectingthedestinationforthebackuparchiveandsettingwhenthebackuptaskshouldberun.Onceyou’vepickedaname,clickthe“Continue”buttontomovetothenextstep.Youcanalsousethe“Cancel”buttontoexittheassistantorthe“Help”buttonforadditionalinformation.
ChoosingtheSourceFilesStuffIt’sSchedulerisdesignedtobeeasytouse.Whenpickingfilestobackup,thedefaultoptionwillsimplybackupallthefilesinyour“Documents”folder.InMacOSX,mostdatathatyouhavecreatedwhileusingyourcomputerwillusuallybestoredsomewhereinyourHomedirectory.ThedefaultinterfacepresentedinthisdialogisdesignedtomakeiteasyforyoutoaddthevariousfoldersinyourHomedirectorytothebackupset.YoucanchoosetoaddtheentireHomedirectorytoyourbackupsetbycheckingthetopiteminthelist.ThiswillbackupallthefilesinyourHomedirectoryincludingnotonlyyourdocumentsbutalsoanyfilesonyourdesktop.Thisoptionalsobackupsyourpersonalpreferencesandsettingsforthevariousapplicationsyouuse.StuffItallowsyoutoaddanyfolder,onanyaccessiblenetworkorlocaldrive,tothelistofitemsthatwillbebackedup.YoucanadditemstothebackuplistsimplybydragginganddroppingthemfromtheFindertotheSchedulerwindow.Youcanalsousethe“+”buttontobrowseforitemstoaddtothelist,orusethe“‐”buttontoremoveoptionalitemsfromthelist.
SettingCriteriaBydefault,StuffItwilladdallfilesandsubfoldersinthedirectories(orfolders)youhavedesignatedtoanewStuffItXarchive.Formostusers,thisisthemostdesirableoption.Insomecaseshowever,youmayonlywanttoarchivespecificfilesfromtheselectedfolder.The“CustomCriteria”dialogprovidesawaytotellStuffItexactlywhichfilesshouldbeincludedorexcludedfromthebackuparchive.
http://my.smithmicro.com
48
ThecriteriadialogworksinthesamewayastheFinder’s“Find...”function.Byaddingsearchcriteriainthisdialog,youcantellStuffIttosearchyourselecteddirectorytofindmatchingitemstobearchived.ThemostcommonuseforthisdialogistotellStuffIttofindfilesthathavechangedinthelastweekandthenaddonlythosefilestoyourweeklybackuparchive.
SettingtheDestinationThepop‐upmenuatthetopofthedestinationpageliststhevariousdestinationoptionstowhichyourbackuparchivecanbesaved.Youcanchoosetobackuptoyourharddrive(althoughthisisn’trecommended),recordableCDsandDVDs,anFTPserver,anexternalharddrive(suchasanexternalFirewireorUSBdevice)oruploadtoyour.MaciDisk.
SchedulingtheTaskYoucanchoosetohaveStuffItautomaticallyrunyourbackuptaskataspecifictimeandthedaysoftheweekonwhichthetaskwillbeexecuted.Remember,ifyouchoosetohavethebackuptaskrunatatimewhenyouwillnotbepresentatyourcomputer(suchaslateatnight,orovertheweekend),youwillneedtomakesurethatthedestinationyouspecifiedwillbeavailableatthattimeandthatithasenoughfreespaceinwhichtosaveyourarchive.Usinganexternalharddriveoraremoteserverasabackupdestinationisthebestwaytodothis.Evenifyouareabletochooseabackupdestinationthatwillenableyoutoscheduleabackupinthemiddleofthenight,makesurethatyouremembertoleaveyourcomputerrunning!StuffItcannotrunascheduledbackuptaskifyourcomputerhasbeenturnedoff.IfascheduledbackuptaskcannotberunbecauseyourMacwasturnedoff,StuffItwillnotifyyouthenexttimeyoustartyourcomputer.
RestoringFilesThearchivesyoucreatewithStuffIt’sSchedulerarestandardStuffItXarchives(.sitx).ToretrievefilesfromaStuffItXarchive,youcanuseStuffItExpander,StuffItDeluxeoranyofthetoolsdescribedinthischapter.Howver,StuffItExpandersupportsaspecialmodespecificallydesignedtotakefilesbackedupbyStuffIt’sSchedulerandplacethembackinthelocationonyourharddrivefromwhichtheyoriginated.ToaccessthisfeatureofStuffItExpander,usethesesteps:
1. LaunchStuffItExpander.2. Choose“Preferences...”fromtheStuffItExpandermenu.3. Clickthe“Destination”buttoninthe“Preferences”dialog.4. Clickthe“ExpandArchives...”pop‐upmenuandchoosethe“Bymerginginto
thelocationspecifiedbytheArchive”option.
http://my.smithmicro.com
49
Whenyouexpandanarchivewiththissettingenabled,StuffItExpanderwillusetheinformationspecifiedinthe“Source”taboftheStuffItDeluxe“GetInfo”dialog(seeabove)topickthelocationtowhichfileswillbeexpanded.Thecontentsofthefoldersinyourarchivewillbemergedintothematchingfoldersonyourharddrive.IfStuffItExpanderneedstoreplaceafileonyourharddrivewithonebeingexpandedfromthearchive,youwillbepromptedtoconfirmwhichcopyofthefileyouwanttokeep.YoucanalsobrowseyourbackuparchivesusingtheStuffItArchiveManagerapplication.Thisallowsyoutoselectivelyexpandjustoneortwofilesfromabackuparchivewithouthavingtorestorethecompletebackup.
OtherFeatures
VersionCheckingArchiveManagerwillcontacttheSmithMicroserveronlaunchtoseeifthereisanewerversionavailable.Ifyouwouldliketodisablethis,uncheckthe“AllowVersionCheck”optionfromthe“StuffItArchiveManager”menu.
ArchiveManagerTroubleshootingThereisaknownissueforMacOS10.5LeopardusersusingScheduledtaskswithMobileMeiDiskasadestination.ManualtaskswiththeiDiskdestinationworkwithoutproblems.
http://my.smithmicro.com
50
SEAMaker‐GettingStarted
What’sanSEA?SEAisanabbreviationforSelf‐ExtractingArchive.SEA’sareafamilyofarchivesthatincludeapplicationcodeallowingthemtobeexpandedwithouttheuseofanexternalapplication.They
areusefulwhenyouaren’tsureifthepersonyou’resendingfilestohasthenecessaryexpansiontool,suchasthefreeStuffItExpander,toopenanarchive.
StuffItSEAMaker™createsSEAsbasedontheStuffItXformatthatrunonMacsrunningMacOS10.4orlater.TheseSEAscaninstallfilestospecifiedtargetareasonauser’sharddrive,orcanprompttheusertoselectadestination.SEAscanalsodisplaygraphicsandtextfiles.Youcancreatemini‐installersthatcandisplayaSplashScreenorlogo,andtext‐basedReadMefilesinadditiontoinstallingfiles.
UsingSEAMakerWhenyoulaunchSEAMakeranew,emptyInstalldocumentiscreated.Tomakeyourinstaller,youneedtoaddstepsor“phases”totheinstallprocess.
AddingFilesTheeasiestwaytoaddfilestoanSEAistodragthePayloaditemsintotheSEAMakerwindowfromtheFinder.Afteryouhavedroppedthefiles,youwillseeanew
“InstallFiles”phaselistedintheSEAMakerwindow.
SettingtheTargetDestinationWhenauserrunsyourSEA,theywillbeprompted(bydefault)tospecifythelocationtowhichtheywantthefilesextracted.However,youcanspecifyaspecifictargetlocation.Clickthearrowinthe“Destination”columnandchooseoneofthedefaultoptionsonthelist(suchasDocuments)orusethe“Other...”optiontospecifyacustomlocation.Ifthefolderyouspecifyisnotpresentonyourrecipient’scomputer,theywillbepromptedtochooseanewdestination.
Tip:IfyouwanttospecifymultipledestinationsforyourPayloadfiles,eachgroupthefileswiththesamedestinationtoitsownphase.
SpecifyingaRemotePayloadSEAMakerinstallerscannowoptionallyretrievetheirpayloadfromyourFTPserverorMobileMeiDisk.Thisallowstheinstalleryourdistributetobeevensmaller.
http://my.smithmicro.com
51
TospecifyanFTPserver:
1. Clickonthe“Source”columnandchooseFTP2. Inthesheetthatappears,fillin:
o TheServer’saddresso Thepathtothedirectorywhereyouwouldliketostorethepayloado Thenameyouwouldliketogivethepayloadfileo AddyourcredentialsforyourFTPaccount.
Whentherecipientrun’stheinstalleryoucanspecifyhowthepayloadwillberetrieved.IfyourFTPserverisalsoaWebserver,youcanselecttheHTTPoptionandfillintheaddress(andpath)tothepayloadfile.IfyourFTPserverisnotalsoaWebserverthenyoucanconfiguretheFTPoption.TheAnonymousoptionwillnotattempttosendausernameandpasswordtoyourFTPservertoretrievethepayload.Ifyourserverdoesn’tallowanonymousaccess,leavethisoptionuncheckedandtheuserwillbepromptedforausernameandpasswordwhentheretrievepayloadphaseisrunning.
DisplayingaSplashScreenToaddasplashscreentoyourSEA,followthesesteps:
1. Clickthe“+”buttonintheSEAMakerwindowtocreateanewphase.2. Choose“DisplayImage”fromthemenuthatappears.3. Usethenavigationdialogthatiscreatedtobrowsefortheimageyouwantto
display.SEAMakersupportsawiderangeofimageformats.Theruleofthumbis,ifQuickTimesupportstheimageformat,itcanbeusedwithSEAMaker.
DisplayingaTextDialogToaddatextdialogtoyourSEA,followthesesteps:
1. Clickthe“+”buttonintheSEAMakerwindowtocreateanewphase.2. Choose“DisplayText”fromthemenuthatappears.3. Usethenavigationdialogthatiscreatedtobrowseforthetextfileyouwant
touse.
BuildingyourSEAYoucancreateaSelf‐ExtractingArchivefromSEAMakerbyusingthe“Build”buttoninthetoolbar.The“Archives”createdbytheStuffItSEAMakerapplicationarenot,however,reallyarchivesatallinthestrictsenseoftheword.Rather,thearchivescreatedbySEAMakerareMacOSXapplication“packages”.TheSEApackagescreatedwithSEAMakercontainaStuffItXarchiveandtheapplicationcodenecessarytoexpandthatarchive,alongwithinstructionscreatedfromyourprofile
http://my.smithmicro.com
52
aboutexactlyhowthearchiveshouldbeexpanded.TheSEApackagealsocontainsanytextfilesandgraphicsyouhavechosentoinclude.
CreatingaDiskImageIfyouplantopostyourSEAontheInternet,werecommendthatyousaveitontoaDiskImage(DMG).
Youcandothisautomaticallybychoosingthe“BuildDiskImage”buttonintheSEAMakertoolbar.Whenyouchoosethisoption,yourSEAwillbesavedontoaDMGfilethatcanbemountedasadiskintheFinder.
RunningInstallersWhenaMacuserreceivesyourSEA,theydouble‐clickittostarttheinstallprocess.DisplayTextphases,DisplayGraphicphasesandInstallFilephaseswilloccurintheorderspecifiedwhenyoucreatedtheinstaller.Ifthearchiveusesaremotepayload,theusermaybepromptedtoenterausernameandpasswordtoretrievethefile.IftheInstallFilesphase(s)aresettopromptforaninstalllocation,theuserwillbepresentedasavedialog.
Note:StuffItSEAMaker’sSEAsaredesignedforOSXonlyandrequireMacOS10.4orlater.
http://my.smithmicro.com
53
StuffItActionsforAutomator‐GettingStarted
WhatisAutomator?AutomatorisatoolincludedintheMacOSthatletsyoucreatescriptsvisuallybyconnectingmodulesorbuildingblocks.YoucanfinditintheApplicationsfolder.Therearetutorialsfor
workingwithAutomatorhere:
http://support.apple.com/kb/HT2488
AppleprovidesActionsformanyApplicationsandfeaturesincludedintheOS.YoucandownloadmoreActionsfromhere:
http://www.apple.com/downloads/macosx/automator
StuffItDeluxeincludesActionsforExpandingfiles,CreatingStuffItX,CreatingZipandCreatingTararchives.
CreatingWorkflowsTocreateaworkflowusingtheStuffItActions,youmustprecedetheStuffItActionwithafilelist.
1. Withthe“FilesandFolders”groupselectedontheleft,youcanpickfrom“GetSelectedFinderItems”,“GetSpecifiedFinderItems”,and“AskforFinderItems”.Whicheveryouchoose,ifyouchoose“FilesandFolders”fromthepop‐upmenu,youwon’tbeasrestricted.Likewiseifyoucheck“AllowMultipleSelection”Youwillbeabletoselectmorethanoneitematatime.
Tip:Usethe“GetSelectedFinderItems”actionifyouwanttocreateaDropBoxthatyoucandragfilesontotoactivate.
2. ThenselectoneoftheStuffItActionsnext.Theycanbefoundinthe“Other”groupatthebottomofthelist.Theoptionsareprettyself‐explanatory.Ifyouclickthe“Options”button,youcancheckthe“Showthisactionwhentheworkflowruns”ifyouwouldliketointeractwiththeWorkflowtonamethearchiveyouarecreatingorsetadirectoryforexpandinginto.Ifyouwanttorunthescriptunattended,thenleavethisoptiondisabled.
3. SaveyourscriptasaWorkflow.Totryitout,justclickAutomator’sRunbutton.YoucanalsosavetheWorkflowasanapplication,thendragfilesonittoactivateit.
http://my.smithmicro.com
54
Tip:YoucanevensaveitasaPluginforiCalandhavethescripttriggeredbyiCalevents.
SharingWorkflowsYoucanshareAutomatorWorkflowsandDropboxeswithothersprovidedtheyhavetherequiredAutomatorActionsinstalledontheirmachine.
TroubleshootingIftheStuffItActionsdon’tappearwhenyoufirstrunAutomator,trylaunchingtheArchiveManagerapplicationfirst,thenrunningtheAutomatorapplication.
http://my.smithmicro.com
55
StuffItCommandLineTools‐GettingStartedStuffItcanbeautomatedusingshellscripts,orrunremotelyviatelnetorSSHsessions.
TheStuffItCommandLineToolsareinstalledin/usr/local/bin/
Thispathisappendedtoyour.profileand.loginfiles.
Thetwoprogramsare(appropriatelynamed):
stuff
unstuff
Toseeahelpscreen,justtype:
‐‐helpafterthecommandandhitenter(typingthecommandbyitselfwithnoargumentswillalsoshowthehelpscreen).
YoucanseewhatversionofthetoolandtheStuffItEngineisinstalledbytyping
stuff–v
…atthecommandprompt.
http://my.smithmicro.com
56
ContactUs
TechnicalSupportYoumaycontactusfortechnicalsupport(availabletoallregisteredusers).YoucanreceiveinformationimmediatelybyvisitingourTechnicalSupportwebsite:
http://my.smithmicro.com/support/index.html
TheonlinesiteprovidesaconstantlyupdatedKnowledgeBaseconsistingofFAQ’s(FrequentlyAskedQuestions).Chancesaregoodthatsomeonehasreportedthesameissueandwe’vepostedinformationaboutit.
Ifyouhaven’tfoundtheanswerafterreviewingthepertinentFAQ’s,youcansubmitaformtoourSupportstaffwhichtheywillrespondtobyemail.Supportrequestsareansweredintheordertheyarereceivedandresponsetimevariesdependingonthenumberofpendingrequests.WethereforerecommendcheckingtheFAQ’s.
WhensubmittingaSupportrequest,youwillneedtoknowthefollowinginformation:
• TheexactversionofStuffItDeluxeyouareusing.• TheexactversionoftheOperatingSystemyouareusing.• IfyouhaveaSerialNumber,youwillhavetheopportunitytoenteritwhen
submittingaSupportRequest.
HowToContactSmithMicroWeb: http://my.smithmicro.com/contact/index.htmlFax: 831‐761‐6206Phone: 831‐768‐3615Mail: SmithMicroSoftware,Inc.
185WestridgeDrive,Watsonville,CA95076
SmithMicroRSSFeedsandMailingListsSubscribetoourRSSfeedsorjoinouremaillists.SmithMicromaintainsanumberofE‐maillistsyoucanjoinwhicharetailoredtoyourspecificinterests.Bygoingto:http://my.smithmicro.com/contact/maillist.htmlyoucanchoosetostayinformedabouttheproductsthatinterestyouand/orSmithMicropressreleases.Youjoinonlytheliststhatinterestyou,andyoucanunsubscribeatanytime.
http://my.smithmicro.com
57
AppendixA:SupportedFormats
Archives
Supported Formats
Typical Filename Extension Expand Browse Modify Create
StuffIt X archives - .sitx √ √ √ √
StuffIt 5 and older StuffIt archives - .sit √ √ √ √
StuffIt 5 and older Mac Self-Extracting archives - .sea √ √ √ √
Zip archives
- .zip
(including encrypted and Zip64 archives) √ √ √ √
Windows Self-Extracting archives
- .exe
(created with StuffIt for Windows or Windows Zip utilities) √ √ √ √
RAR archives
- .rar
(including encrypted archives) √ √
TAR archives - .tar √ √ √ √
Tarballs (Compressed TAR archives)
Gzip Compressed Tar - .tar.gz, .tgz, .taz √ √ √
Bzip Compressed Tar - .tar.bz, .tbz √ √
Bzip2 - .tar.bz2, .tbz2 √ √ √
http://my.smithmicro.com
58
Compressed Tar
UNIX Compressed Tar - .tar.Z, .tz √ √ √
LZMA Compressed Tar - .tar.lzma, .tlzma √ √
7-Zip archives - .7z √
Compact Pro archives
- .cpt
(including self-extracting archives) √ √
Windows CAB Files - .cab √
Lha archives - .lha, .lzh √ √
Arj archives - .arj √
Arc archives - .arc √
Comic Book Archives
CBZ - .cbz √ √ √
CBR - .cbr √ √
CBT - .cbt √ √ √
CB7 - .cb7 √
Segments
Supported Formats
Typical Filename Extension Expand Browse Modify Create
StuffIt X segments
- .part01.sitx, .part02.sitx, etc. √ √ √
StuffIt 5 and older segments - .sit.1, .sit.2, etc. √ √ √
Zip segments - .z01, .z02, etc. √
http://my.smithmicro.com
59
Split Archives
- .001, .002, etc. (used by some Zip, Rar and 7-Zip implementations) √
Compressed Files
Supported Formats
Typical Filename Extension Expand Browse Modify Create
StuffIt SpaceSaver compressed files n/a √ n/a
gzip compressed files - .gzip, .gz √ n/a √
bzip compressed files - .bzip, .bz √ n/a
bzip2 compressed files - .bzip2, .bz2 √ n/a √
UNIX compressed files - .z, .Z √ n/a √
lzma compressed files - .lzma √ n/a
Encoded Files
Supported Formats
Typical Filename Extension Expand Browse Modify Create
AppleSingle encoded files n/a √ n/a √
Binhex encoded files - .hqx √ n/a √
MacBinary encoded files - .bin √ n/a √
UUencode encoded files - .uu, .uue √ n/a √
Base64/MIME encoded files - .b64, .mme, .mime √ n/a
http://my.smithmicro.com
60
yEncode encoded files - .yenc, .ync √ n/a
BtoAText encoded files - .b2a, .btoa √ n/a
Encoded Archives
Supported Formats
Typical Filename Extension Expand Browse Modify Create
Binhex encoded StuffIt X archives - .sitx.hqx √ √ √
Binhex encoded StuffIt archives - .sit.hqx √ √ √
Binhex encoded Self-Extracting archives - .sea.hqx √ √ √
MacBinary encoded StuffIt X archives - .sitx.bin √ √ √
MacBinary Encoded StuffIt archives - .sit.bin √ √ √
MacBinary encoded Self-Extracting archives - .sea.bin √ √ √
UUencode encoded Zip archives - .zip.uu, .zip.uue √ √ √
Other
Supported Formats
Typical Filename Extension Expand Browse Modify Create
PrivateFile encrypted files - .pf √ n/a
http://my.smithmicro.com
61
AppendixB:AllaboutCompression
Whatiscompression?Accordingtohttp://en.wikipedia.org/wiki/Data_compression:
Compressionistheprocessofencodinginformationusingfewerbits(orotherinformationbearingunits)thanamoreobviousrepresentationwoulduse,throughuseofspecificencodingschemes.
Thisisdonebylookingforredundancyinthebitsthatrepresentafileandreplacingthesewithtokensthatusefewerbits.Compressionisreversedbyreplacingthetokenswiththeoriginalvalues.
Lossyvs.LosslesscompressionSomecompressionmethods(typicallymultimediaformatssuchasJPEGandMP3)discardinformation(loss)toachievesmallerfilesizes.Thistypeofcompressioncan’tbereversedandtheresultingfilewillnevermatchtheoriginal.Thereisatrade‐offintherelationshipoffilesizetoqualitydegradation.Lossycompressionisnotusedinapplicationswherecompleterestorationoftheoriginalfileisnecessary(suchasyourfinancialrecords!).StuffItuseslosslesscompressionmethods.
Tip:Duetothefactthatlossycompressedfileshavelimitedredundancytheydon’tfurthercompresswellwhenusingformatslikeZip.StuffItXhasproprietarytechnologytolosslesslyrecompressmanyoftheselossycompressedformatssignificantly.
Whycompress?Compressionmakesfilessmallersotheytakeuplessstoragespaceandcanbetransferredfasterfrommachinetomachine.Combinedwitharchiving,itbecomesausefulwaytoorganizefilesandprojects.
Compressingvs.ArchivingCompressionistypicallyappliedtoasinglefile.Archivingallowsahierarchyoffilesandfolderstobegroupedtogetherforcompression.Mostarchiveformatsincludecompressionaspartofthearchivingprocess.TheUNIXTapeArchive(tar)formatdoesnotandittypicallypost‐compressedwithgzip(gz),bzip2(bz2),orUNIXcompress(Z).
EncryptionSimilartocompression,encryptionistheprocessofobfuscatingafileusingvariousschemessuchasRC4,DES,BlowfishandAESforsecuritypurposes.
http://my.smithmicro.com
62
EncodingEncodingistheprocessofconvertingfilestoallowthemtobetransferredintactfromoneplatformviaanotherplatform.Forexample,pre‐OSXMacintoshfilestypicallyhavetwoparts:aresourceforkandadatafork.Sincenootherplatformusethisdual‐forkformat,olderMacintoshfilesneedtobeencodedtopreservetheresourceforksbeforebeingtransferredtoanon‐Mac.TypicallythisisdonewithMacBinary(.bin)encoding.
Filesthatarerepresentedwithan8‐bitcharacterset(ie:binaryfiles)oftenneedtobeconvertedtoa7‐bitcharacterset(ie:textfiles)tobeattachedtoemailsorpostedtoUseNetnewsgroups.TypicallythisisdonewithBinHex(.hqx)forolderMacfilesandUUencoding(.uuor.uue)fornon‐Macspecificfiles.
Note:Encodingdoesnotcompressafile.Oftenitactuallymakesagivenfilelarger.
Forcross‐platformcompatibility,StuffIt5andStuffItXuseasinglefileformat(ie:nocriticaldataisstoredintheresourcefork)andasaresultcanbeusedinsteadofMacBinaryencoding.IftheresourceforkofaStuffIt5orStuffItXarchiveisstrippedoff,thedatacontainedinthearchivewillstillbecompletelyintact.ThereisnoneedtoMacBinaryencodeaStuffIt5orStuffItXarchive.
StuffItXalsoincludestextencodingoptionswithinitsownformattoallowfortextencodingatthetimeofcompressionwithoutpost‐processing.
StuffItvs.StuffIt5vs.StuffItXTheoriginalStuffItformatdesignedbyRayLauin1987wasanimplementationofLZWcompressionfortheMacintosh.ItsupportedtheMac’sdual‐forkformatandsupportedabrowsablehierarchy.Userscouldexpandindividualitemsfromthearchiveaswellasmodifyexistingarchives.
TheoriginalStuffItformatwentthroughseveralsmallrevisionsbeforeamajorredesign.
StuffIt5wasintroducedinNov.1998withStuffItDeluxe5forMacintosh.Itwasdesignedtoofferbettercompression,andtobecross‐platformfriendly.ItbecameavailabletoWindowsuserswiththereleaseofDropStuffforWindows5.0inAug.1999.
StuffItXwasintroducedinSep.2002withStuffItDeluxe7.0forMacintosh.Itwasdesignedtobeextendable,supportmorecompressionmethods,supportlongfilenames,supportUNIXandWindowsfileattributes.Whilemostexistingcompressionformatswilluseonetypeofcompressionalgorithm(forexample:Zipandgzipuse“Deflate”,bzip2uses“BWT”).CompressionwithStuffItXcanuseanyoffouralgorithmsaloneorincombinationtogetthemostoptimalcompressionforany
http://my.smithmicro.com
63
particularsetofdata.Additionally,StuffItXhasbeenextendedwithoptimizedcompressionmethodsforparticulartypesofdatasuchasJPEGs,and24‐bitimages.
http://my.smithmicro.com
64
AppendixC:CreatingArchivesWhencreatinganarchive,whatismostimportant?IfyouaretryingtofitfilesontoaCD,oraUSBFlashdrive,thenSizemaybethemostimportantfactortoyou.Ifyouarejustgroupingabunchofrelatedfilestogether,Speedmaybemoreimportantthansize.IfyouarepostingfilestoanInternetsiteforpublicdistribution,thenportabilitymaybethemostimportantfactor.
ChoosingtheRightFormatTheStuffItStandardandStuffItDeluxesuitesletyoucreatearchivesinthreeformats:Zip,Tarandourowncutting‐edgeStuffItXformat.
StuffItDeluxealsoofferssomeolderlegacyformatswhicharedescribedattheendofthissection.
TarisaformatthatiscommononUNIXandLinuxsystems.SinceOSXisbasedonUNIX,thereissomesupportbuiltintotheOSforexpandingthesefiles.Tararchivesarenotcompressedbydefaultandneedsomepost‐compressionapplied(suchasGzip,Bzip2,orUNIXCompress).IfyouaresendingfilestoaUNIXorLinuxuser,Tarisareasonablechoice.ThecompressionofferedbyGzip,andBZip2areadequateformostpurposes.
Zipisaubiquitousformat.MostcomputerplatformsincludingOSXhavesomeformofZipexpansionavailable.ThecompressionofferedbytheZipformatissimilartothatoftheGzipformatandissatisfactoryformostpurposes,butreadthenotesaboutOptionsbelow.
StuffItXwasintroducedinSep.2002.FreeexpansiontoolsareavailableforbothMacintoshandWindows.StuffItXwasdesignedtobeextendable,supportmorecompressionmethods,supportlongfilenames,supportUNIXandWindowsfileattributes.Whilemostexistingcompressionformatswilluseonetypeofcompressionalgorithm(forexample:Zipandgzipuse“Deflate”,bzip2uses“BWT”).CompressionwithStuffItXcanuseanyoffouralgorithmsaloneorincombinationtogetthemostoptimalcompressionforanyparticularsetofdata.
Additionally,StuffItXhasbeenextendedwithoptimizedcompressionmethodsforparticulartypesofdatasuchasJPEGs,and24‐bitimages.
Thisreleaseintroduces“DuplicateFolding”.WhencreatingaStuffItXarchive,ifduplicateitemsarebeingcompressed,onlyonecopyisstoredinthearchive,withpointerstotheduplicates.Whenexpanded,theduplicatecontentisretrievednormally.Fordatasetswhereduplicateitemsexist,thiscanreducethearchivesizeandcompressiontime.Whensizeisafactor,StuffItXistherightchoice.
http://my.smithmicro.com
65
ChoosingtheRightOptionsMostoftheseoptionsaresetintheCompressionpreferencesforeachStuffItapplication.
EncryptionWhenyouaresendingsensitivefilestootherpeople,youcanuseencryptiontoprotectyourfileswithapassword.Thismeansifsomeoneotherthanyourintendedrecipientreceivesthearchivethatthefilesarestoredin,theywillnotbeabletoopenitandgainaccesstoyourdocuments.EncryptionisonlyavailablewhenyouarecreatingStuffItandZiparchives.
StuffItXEncryptionvsZipEncryptionStuffItXoffersfourdifferentencryptionmethods,butdefaultstothestronger512‐bitRC4encryption.Also,theencryptioninStuffItXencryptstheentirearchive.Apasswordisrequiredtovieworexpandthecontentsofthearchive.
Zipuses256‐bitAESencryptionbutencryptsonlytheitemsinsidethearchive.ItispossibletobrowsethecontentsofaZipwiththepasswordonlybeingrequiredtoexpanditemsfromthearchive.
SupportforexpandingencryptedZiparchivesislimited.WhiletheStuffItutilitiescanexpandencryptedZips,manytoolsincludingtheZiputilitiesbuiltintoWindowsandOSXcannot.
Note:Regardlessofwhichformatyouchoose,whenyoucreateanencryptedarchive,besuretomakeacarefulnoteofthepasswordthatyouused.SmithMicroisnotabletorecoverthecontentsofanencryptedarchiveifthepasswordhasbeenlost.Thereisno“BackDoor”.
PreserveMacintoshContentBeforeOSX,Macintoshhadadual‐forkformat.Eventhoughitwashiddenfromtheuser,mostfileshadtwoparts,aResourceForkandaDataFork.MostothercomputerplatformsuseasingleDataFork.Insomecases,likeClassicMacapplications,theResourceForkwascritical.Inothercases,likeJPEGimages,theimportantdatawasstoredintheDataForkandtheResourceForkwasnotimportant.InOSX,ResourceForksarelessimportant,butsometimesstillneeded.FormatssuchasZipandTardonotnativelystorethisinformation.Enablingthe“PreserveMacintoshContent”optionallowsanyResourceForkstobeencodedwhenaddedtoanarchive.IfaMacuserexpandsthesearchives,theResourceForkswillbeintact.Non‐MacuserswillseeanextrafolderofalltheResourceForkdataandcandiscardit.StuffItXwasdesignedwithResourceForksinmindandhasnoneedforthisoption.
http://my.smithmicro.com
66
BackwardsCompatibleArchivesStuffItXisacutting‐edgearchiveformat.Weperiodicallyaddnewfeaturestotheformattoprovidebettercompression.SometimesthesenewfeaturesusecompressionmethodsthatwerenotdesignedintoolderversionsofStuffItandarethereforeincompatible.YoucaneasilymakeStuffItXarchivesthatarecompletelybackwardscompatibleallthewaybacktoStuffIt7forMac.Justcheckthe“CreateBackwardsCompatibleArchives”optionintheCompressionPreferences.
LegacyFormatsStuffIt(.sit)–AlsoknownasStuffIt5,thisarchiveformatwasdesignedpriortoOSX.Itwasdesignedtobecross‐platformcompatible,butstillbeMacintoshfile‐friendly.ThisformatisbestusedwhencreatingarchivesforveryoldMacintoshesrunningClassicMacOSpriortoSystem9.TheformathaslimitationsrelatingtolongfilenamesandUNIXfilepermissions.
MacOSClassicSEA–TheseareSelf‐ExtractingArchives(applications)basedontheStuffIt5format.ThesehaveallthesamelimitationsoftheStuffIt5formatabove.Additionally,becauseofthenatureoftheClassicMacfileformatitisbesttoencodethesewithMacBinaryorBinHexbeforetransferringviatheinternet.
WindowsSEATheseareSelf‐ExtractingArchives(applications)basedontheStuffIt5format,butincludeapplicationcodespecificallyforWindows.
LHa‐ThisformatwaspopularforcompressingMODdigitalaudiofilesandotherfilesonAmigaandoldMS‐DOSsystems.AccordingtoWikipediaitremainspopularinJapan:
http://en.wikipedia.org/wiki/LHA_(file_format)
http://my.smithmicro.com
67
AppendixD:FormatCompressionOptions
StuffItXOptionsCompressionLevel:Aswellaschangingtheformatinwhichthearchivewillbecreated,youcanalsochangethecompressionlevelthatwillbeusedwhenitemsareaddedtothearchive.Youcanchoose"BetterCompression","FasterCompression"or"NoCompression";asthenamessuggesttheFastercompressionmethodmakesarchivesmorequickly,theBettercompressionmethodcreatessmallerarchivesandtheNoCompressionoptiongroupsfilestogetherintoanarchivewithoutcompression.Anadditionalchoice,Customisalsoavailable.WhenCustomisselectedyoucanusetheStuffItXExpertCompressionSettingsdialog(below)toconfigurehowStuffItwillcompressyourfiles.
SegmentSize:TheSegmentSizepop‐upmenucanbeusedtoselectoneofseveralcommonpre‐definedsegmentsizechoices.Thesepre‐setoptionsaredesignedtocoverarangeofpopularbackupmediasuchasZipdisks,andCDROMS.
EncryptArchiveswithPassphrase:Whenthisoptionischecked,thearchivesyoucreatewillbeencryptedwithapassphrase.Youwillbepromptedtoprovideapassphrasebeforethecompressionbegins.Whenyoucreateanarchivewithencryption,besuretomakeacarefulnoteofyourpassphrase.SmithMicroSystemscannotrecoverfilesfromencryptedarchivesifyouhavelostyourpassphrase.Passphrasesarecasesensitive.
CreateIndexArchives:Createsaproxy"Index"archiveatthesametimeaStuffItXarchiveiscreated.ClickhereformoreinformationonIndexArchives.
CreateBackwardsCompatibleArchives:WhenthisoptionischeckedStuffItXArchiveswillbecreatedusingonlycompressionmethodscompatiblewithversion7.0ofStuffItExpanderforMacintosh.ClickhereformoreinformationaboutRecommendedExpanderVersions
Recompression:StuffItincludesspecialoptimizescompressorsforcertainfiletypes.Theserecompressorsmakefilessmallerby'disassembling'thestructureofthedatatypeandcompressingitmoreefficientlyusingtheStuffItXformat'sowncompressors.WhentheitemisexpandedfromtheStuffItXarchive,thestructureforthatparticulardatatypeisreassembled.
Note:Generallythisresultsinoutputthatisidenticaltotheoriginal,butinsomeinstancestheoutputmaynotbe100%identical.Thecontentitself,andanyancillarydataisneverlostjustthebitencodingchangessometimes.
http://my.smithmicro.com
68
AgoodexampleisZiprecompression.TherearemanycompressionattributesthatcanbeusedtocreateaZiparchive.WhenrecompressingaZipintoaSITxarchive,theZipisopenedanditscontentiscompressedintotheSITxarchive.Uponexpansion,theZiparchiveisrecreated.TherecreatedZiparchiveandtheoriginalZiparchivemayhavedifferentcompressionattributesandarethereforenotidentical,butifeachoftheZipsisexpandedtheresultingoutputwillbeidentical.Thisexamplealsoappliestoimageformatsthatcontaincompressedinformationaspartofthestructure.Thisiscommonlyreferredtoas"pixelperfect".Identicaloutputiscommonlyreferredtoas"bitperfect".
StuffItincludescustomrecompressorsforthesefileformats:
• JPEG(.jpg,.jpeg)‐Alwaysbit‐perfect
TheJPEGcompressorhasanadditionaloption:IncludeThumbnails.Whenthisoptionisenabled,asmallthumbnailoftheimageisstoredinthearchiveforquickpreviewing.
• JPEGlossless(.jls)‐pixel‐perfect• JPEG2000(.j2k)‐pixel‐perfect
Noterecompressionisonlyappliedwhenaj2kfileislosslessencoded
• Bitmap(.bmp)‐Alwaysbit‐perfect• GIF(.gif)‐pixel‐perfect• TIFF(.tif,.tiff)‐dependsondata• PSD(.psd)‐dependsondata• PNG(.png)‐pixel‐perfect• PICT(.pict,.pct)‐pixel‐perfect• PXM(.pbm,.pgm,.ppm)‐Alwaysbit‐perfect• MP3(.mp3)‐Alwaysbit‐perfect• Zip(.zip,.cbz)‐pixel‐perfect• PDF(.pdf)‐dependsondata
Checkeachtypeforwhichyouwishtoenablerecompression.
StuffItXExpertCompressionSettings
CompressionMethodCompressionmethodallowsyoutoselectdifferentcompressorsforusewhenaddingfilestoaStuffItXarchivewithcompression.
NoCompression(Method0):Fileswillbeaddedtothearchivewithoutbeingcompressed.
http://my.smithmicro.com
69
FastestCompressionandExpansion(Method1):Method1providescompressionthatisoptimizedforspeedofcompressionanddecompression.Itworksbyreplacingaseriesofbyteswithareferencetoapreviousoccurrenceofthesameseriesofbytes.Method1isusedwhenthecompressionlevelissetto"Faster".
BestBinaryCompression(Method2):Method2isoptimizedforthecompressionofbinaryfiles(suchasapplications)andalsoforfastdecompression.Method2worksinthesamewayasMethod1,exceptthatithasamoreexactwayofrepresentingtheoffsetsandlengths,whichmakesitcompressalittlemore,butatthecostofslowercompressionanddecompression.TypicallyMethod2willprovideyouwiththebestresultswhenyou'recompressingapplications.
BestSize/SpeedTradeOff(Method8):Method8providesthebesttrade‐offbetweencompression/decompressionspeedandarchivefilesizeandworkswellonavarietyofdifferentfiletypes.Thiscompressionmethoddoesareversiblesortonthedata,whichplaceslikedataclosertogetherwhichmakesitmorecompressible.Note:ThismethodreplacesMethod3andarchivescreatedwiththiscompressionmethodmustbeopenedwithStuffItExpander9.02orlaterontheMacintosh,orStuffItExpander9.0orlateronWindows.
BestTextCompression(Method4):Method4providescompressionthatisprimarilyoptimizedfortext.Thiscompressionmethodworksby"predicting"whatthenextbytewillbebasedonpreviousdata.Forexample,ifitispredictingthebytefollowing"t"and"h",itwillgivehighprobabilitiesto"e",and"a".
ChoosebyFileType(Method5,aka"Mix"):Thiscompressionmethodusesacombinationofthe"BestTextCompression"methodandthe"BestSizeSpeedTradeOff"methodtoachievebetterresults.Ifthefilebeingcompressedisamostlytextfile,itusesMethod4,otherwiseitusesMethod8.AsMethod8(seeabove)canpotentiallybeusedinthecreationofarchives,StuffItExpander9.02ontheMacintosh,andExpander9.02onWindowswillberequiredtoopenthesefiles.
LevelsandExtentsLevelsandExtentsarevariablesusedtooptimizeperformance(ie:compressionspeedvs.expansionspeedvs.compressedsize)foraparticularsetofdata.
Levels:Levelsgenerallyset"howhard"eachmethodtriestocompress.Inthematchingalgorithms(Method1&2[FastestCompression&BestBinaryCompression]),levels1‐9generallycorrespondtogzip'scompressionlevels.Thehigherthenumbertheharderittriestofindamatch(morecompression,butslower).Levelsabove9useadifferent,moreexhaustivesearchforpreviousmatches,whichgetsextracompression,butattheexpenseofspeed.
http://my.smithmicro.com
70
Inthe"prediction"algorithm,thelevelcorrespondstohowmanypreviousbytestousewhenmakingtheprediction.Note:NotallthecompressionmethodsusedbyStuffItXsupportsettingcompressionlevels.Youcannotspecifycompressionlevelsformethods8[BestSize/SpeedTradeOff].
Extents:Extentshasadirectrelationshiptohowmuchmemoryisused.InMethods1&2[FastestCompression&BestBinaryCompression],theextentsetshowfarbacktolookforamatch.InMethod4[BestTextCompression],extentsetshowmuchmemorytouseforstoringthepredictioninformation.
EncryptionMethodStuffItXarchivescanbecreatedwithencryption.Thereare4compressionmethodssupported:
• RC4‐Supportsupto512bitkeylengths.• DES‐Supportsto64bitkeylengths• BlowFish‐Supportsupto448bitkeylengths• AES‐Supportsupto256bitkeylengths
ErrorCorrectionStuffItXarchivescanbecreatedwithErrorCorrection.Addingerrorcorrectioncodetoanarchivewillincreaseitssize,butitsavailabilityallowstheStuffItEnginetoreconstructdatadamagedastheresultofbadmediaortransfererrorsduringthedecodephase.Youcanvarytheamountoferrorcorrectioncodeappliedtoanarchiveduringtheencodephase.Themoreerrorcorrectionyouadd,thelargerthearchivewillbecome.Butmoreerrorcorrectionalsoaddstheabilitytorepairlargerdisasters.Itis,ofcourse,possibletohavelargeenoughdamagethatevenerrorcorrectionwillnotbeabletosavetheentirecontentsofthearchive.Therangeofvaluessupportedareasfollows:
• 1/128ofablock(1%Overhead)• 1/64ofablock(3%Overhead)• 1/32ofablock(6%Overhead)• 1/16ofablock(14%Overhead)• 1/8ofablock(33%Overhead)
TextEncodingStuffItXarchivescanbeconvertedtoASCIItextformat.Threetextencodingmethodsareavailable,Base64(‐L1),Base85(‐L2)andBase222(‐L3).ThelevelsofavailabletextencodingdeterminehowmuchofthefullACSIIcharactersetwillbeusedtoencodethedata.Themorecharactersused,thelesssizeoverheadwillbeimposedasaresultoftranslatingthebinarydataofthearchiveintotextcharacters.WhensendingarchivesviaE‐mail,itisbesttouseBase‐64.Thisusesthefewest
http://my.smithmicro.com
71
characters,butasaresultisthemostcompatible.Base222isagoodchoiceiffilesarebeingpostedtoanewsgroup.
OptimizersOptimizersarespecialcompressionmethodsdesignedtohandlespecificfiletypes.StuffItincludesoptimizersdesignedtocompressWavesoundfiles(.wav),TIFFgraphics(.tif,.tiff),andtextfiles(.txt).
BlockModeTheBlockModesettingdetermineswhetherStuffItwillgrouplikefilestogetherinordertocompressthemmoreefficiently.Thisallowsthecompressortobenefitfromalongerhistory,andtobenefitfromredundancythatmayoccuracrossmultiplefiles.
Dependingonthedataset,BlockModecanprovideamarkedimprovementincompressionrations,andisgenerallyatleastasfastascompressingfilesindivdually.
ZipOptionsCompressionlevel:Aswellaschangingtheformatinwhichthearchivewillbecreated,youcanalsochangethecompressionlevelthatwillbeusedwhenitemsareaddedtothearchive.ThechoicesareFasterCompressionandBetterCompression;asthenamessuggest,theFasterCompressionmethodmakesarchivesmorequickly,andtheBetterCompressionmethodcreatessmallerarchives.Anadditionalchoice,Customisalsoavailable.WhenCustomisselectedyoucanusetheExpertCompressionSettingsdialogtodeterminehowStuffItwillcompressyourfiles.
Encryptarchiveswithpassphrase:Whenthisoptionischecked,thearchivesyoucreatewillbeencryptedwithapassphrase.Youwillbepromptedtoprovideapassphrasebeforethecompressionbegins.Whenyoucreateanarchivewithencryption,besuretomakeacarefulnoteofyourpassphrase.SmithMicroSystemscannotrecoverfilesfromencryptedarchivesifyouhavelostyourpassphrase.Passphrasesarecasesensitive.
PreserveMacintoshContent:ThisoptiondetermineswhetherornotMacintoshspecificfileattributes(suchasaresourceforkandFinderinformation)ispreservedwhenaddingfilestoZiparchives.Typically,ifyouaresendingfilestoaWindowsuseryoudonothavetopreservethisinformation,asitwillnotbeusedonaWindows‐basedcomputer.IfyouaresendingfilestoaMacintoshuser,wewouldrecommendthatyoupreserveMacintoshfileinformationbysendingyourfilesintheStuffItXformatwhichisdesignedtosupportMacintoshfilesproperly.IfyoudoneedtosendMacintoshfilestootherMacintoshusersinZipformat,however,checkingthisoptionwillpreserveMacintoshfileinformationinawaythatisnow
http://my.smithmicro.com
72
compatiblewiththeZipimplementationusedintheFinderinMacOSX10.3andlater.
ZipExpertCompressionSettingsCompressionMethod:WhencreatingZip(.zip)archivesyoucanchoosebetweenthefollowingcompressionmethods:"Deflate"and"Deflate64".DeflateisthedefaultthatallZip‐compatibleapplicationsuse.Notallthird‐partyZiptoolssupportDeflate64.IfyouaregoingtoshareZipfileswithothers,youshouldusetheDeflateoption.Youcanalsochoosetouse"Nocompression"whencreatingZiparchives.
CompressionLevel:YoucansetthecompressionlevelforZipcompressionbetween1and15.Atlevel1compressionwillbeveryfast,butthearchiveswillbelarger.Atlevel15compressionwillbeveryslow,butthearchiveswillbeverysmall.ChangingthecompressionlevelhasnoeffectonthecompatibilityofthearchivewithotherZip‐capableprograms.
TarOptionsCompressionMethod:Tararchives,bydefault,containnocompression.Youcanchoosetopost‐compressaTararchiveusingeitherGzip,Bzip2,orUNIXCompression.
CompressionLevel:WhenyouhaveselectedacompressionmethodtouseinconjunctionwithTararchives,youcanthenselectacompressionleveltobeused.
PreserveMacintoshContent:ThisoptiondetermineswhetherornotMacintoshspecificfileattributes(suchasaresourceforkandFinderinformation)ispreservedwhenaddingfilestoTararchives.Typically,ifyouaresendingfilestoaWindowsuseryoudonothavetopreservethisinformation,asitwillnotbeusedonaWindows‐basedcomputer.IfyouaresendingfilestoaMacintoshuser,wewouldrecommendthatyoupreserveMacintoshfileinformationbysendingyourfilesintheStuffItXformatwhichisdesignedtosupportMacintoshfilesproperly.
TarExpertCompressionSettings
TarCompressionMethodWhencreatingbzip2(.tbz),gzip(.tgz),orUNIXCompressed(.tar.Z)Tararchives,the"Custom"settingsletsyousetthecompressionlevel.Levelsgenerallyset"howhard"eachmethodtriestocompress.Youcanalsochoosetouse"Nocompression"whencreatingTararchives.
bzip2:Youcansetthecompressionlevelforbzip2compressionbetween1and9.Atlevel1compressionwillbeveryfast,butthearchiveswillbelarger.Atlevel9compressionwillbeveryslow,butthearchiveswillbeverysmall.
http://my.smithmicro.com
73
gzip:Youcansetthecompressionlevelforgzipcompressionbetween1and15.Atlevel1compressionwillbeveryfast,butthearchiveswillbelarger.Atlevel15compressionwillbeveryslow,butthearchiveswillbeverysmall.
UNIXCompress:YoucansetthecompressionlevelforUNIXCompresscompressionbetween1and5.Atlevel1compressionwillbeveryfast,butthearchiveswillbelarger.Atlevel5compressionwillbeveryslow,butthearchiveswillbeverysmall.
http://my.smithmicro.com
74
AppendixE:GettingandDistributingtheFreeExpanderMacintoshandWindowsuserscanexpandStuffItXarchives,providedtheyhaveacopyofourfreeexpansiontool,StuffItExpander.Forthemostbackwards‐compatiblearchivecheckthe"CreateBackwardsCompatibleArchives"compressionoptionintheStuffItapplicationpreferencesyouareusing(DropStuff,MagicMenu,ArchiveManager).
ThemostcurrentversionofStuffItExpandercanbedownloadedfrom:
http://www.stuffIt.com/expander
OS Version Recommended Expander Version
Mac OS 8.6 - 9.2.2 (Classic Mac OS) - StuffIt Expander 7.0.3 Mac OS 10.0 (Cheetah), 10.1 (Puma), 10.2 (Jaguar)
- StuffIt Expander 8.0.2 Mac OS 10.3 (Panther) - StuffIt Expander 10.0.2 Mac OS 10.4 (Tiger), 10.5 (Leopard) - StuffIt Expander 2009 Windows 98SE - StuffIt for Windows 9.0 Windows 2000 or later - StuffIt for Windows 12.0.1 LegacyversionsofAladdin/Allume/SmithMicrosoftware,canbefoundinoursoftwarelibraryarchiveshere:
ftp://ftp.allume.com/pub/archive/
Note:WhileweencourageyoutofreelydistributeStuffItExpandertofriends,andcoworkers,youmaynotincludeStuffItExpanderaspartofanycommercialproductorservice.ForinformationonlicensingStuffItExpanderforcommercialdistribution,pleasecontactSmithMicroSales.
http://my.smithmicro.com
75
AppendixF:AcknowledgementsPortionsofthisSmithMicroSoftwaremayutilizethefollowingcopyrightedmaterial,theuseofwhichisherebyacknowledged:
Sparkle
Copyright(c)2006AndyMatuschak
Permissionisherebygranted,freeofcharge,toanypersonobtainingacopyofthissoftwareandassociateddocumentationfiles(the"Software"),todealintheSoftwarewithoutrestriction,includingwithoutlimitationtherightstouse,copy,modify,merge,publish,distribute,sublicense,and/orsellcopiesoftheSoftware,andtopermitpersonstowhomtheSoftwareisfurnishedtodoso,subjecttothefollowingconditions:
TheabovecopyrightnoticeandthispermissionnoticeshallbeincludedinallcopiesorsubstantialportionsoftheSoftware.
THESOFTWAREISPROVIDED"ASIS",WITHOUTWARRANTYOFANYKIND,EXPRESSORIMPLIED,INCLUDINGBUTNOTLIMITEDTOTHEWARRANTIESOFMERCHANTABILITY,FITNESSFORAPARTICULARPURPOSEANDNONINFRINGEMENT.INNOEVENTSHALLTHEAUTHORSORCOPYRIGHTHOLDERSBELIABLEFORANYCLAIM,DAMAGESOROTHERLIABILITY,WHETHERINANACTIONOFCONTRACT,TORTOROTHERWISE,ARISINGFROM,OUTOFORINCONNECTIONWITHTHESOFTWAREORTHEUSEOROTHERDEALINGSINTHESOFTWARE.
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
Growl
Copyright(c)TheGrowlProject,2004
Allrightsreserved.
Redistributionanduseinsourceandbinaryforms,withorwithoutmodification,arepermittedprovidedthatthefollowingconditionsaremet:
1.Redistributionsofsourcecodemustretaintheabovecopyrightnotice,thislistofconditionsandthefollowingdisclaimer.
2.Redistributionsinbinaryformmustreproducetheabovecopyrightnotice,thislistofconditionsandthefollowingdisclaimerinthedocumentationand/orothermaterialsprovidedwiththedistribution.
http://my.smithmicro.com
76
3.NeitherthenameofGrowlnorthenamesofitscontributorsmaybeusedtoendorseorpromoteproductsderivedfromthissoftwarewithoutspecificpriorwrittenpermission.
THISSOFTWAREISPROVIDEDBYTHECOPYRIGHTHOLDERSANDCONTRIBUTORS"ASIS"ANDANYEXPRESSORIMPLIEDWARRANTIES,INCLUDING,BUTNOTLIMITEDTO,THEIMPLIEDWARRANTIESOFMERCHANTABILITYANDFITNESSFORAPARTICULARPURPOSEAREDISCLAIMED.INNOEVENTSHALLTHECOPYRIGHTOWNERORCONTRIBUTORSBELIABLEFORANYDIRECT,INDIRECT,INCIDENTAL,SPECIAL,EXEMPLARY,ORCONSEQUENTIALDAMAGES(INCLUDING,BUTNOTLIMITEDTO,PROCUREMENTOFSUBSTITUTEGOODSORSERVICES;LOSSOFUSE,DATA,ORPROFITS;ORBUSINESSINTERRUPTION)HOWEVERCAUSEDANDONANYTHEORYOFLIABILITY,WHETHERINCONTRACT,STRICTLIABILITY,ORTORT(INCLUDINGNEGLIGENCEOROTHERWISE)ARISINGINANYWAYOUTOFTHEUSEOFTHISSOFTWARE,EVENIFADVISEDOFTHEPOSSIBILITYOFSUCHDAMAGE.
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
RBSplitView
byRainerBrockerhoff
http://www.brockerhoff.net/
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
MUPhotoView
Copyright(c)2006BlakeSeely
http://www.blakeseely.com
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
7Zipsourcecode
~~~~~~~~~~~~~~~~~
Licenseforuseanddistribution
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7‐ZipCopyright(C)1999‐2007IgorPavlov.
Licensesforfilesare:
Allfiles:GNULGPL
http://my.smithmicro.com
77
GNULGPLinformation
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
Thislibraryisfreesoftware;youcanredistributeitand/ormodifyitunderthetermsoftheGNULesserGeneralPublicLicenseaspublishedbytheFreeSoftwareFoundation;eitherversion2.1oftheLicense,or(atyouroption)anylaterversion.
Thislibraryisdistributedinthehopethatitwillbeuseful,butWITHOUTANYWARRANTY;withouteventheimpliedwarrantyofMERCHANTABILITYorFITNESSFORAPARTICULARPURPOSE.SeetheGNULesserGeneralPublicLicenseformoredetails.
YoushouldhavereceivedacopyoftheGNULesserGeneralPublicLicensealongwiththislibrary;ifnot,writetotheFreeSoftwareFoundation,Inc.,59TemplePlace,Suite330,Boston,MA02111‐1307USA
http://my.smithmicro.com
78
AppendixG:EndUserLicenseAgreement Smith Micro End User License Agreement
This End User License Agreement ("EULA") is between you (both the individual installing the Software and any single legal entity on behalf of which such individual is acting) ("you" or "your") and Smith Micro Software, Inc., and/or its subsidiaries ("Company").
PLEASE READ THIS EULA CAREFULLY BEFORE USING THE SOFTWARE. TAKING ANY STEP TO SET-UP, INSTALL, OR USE ANY PORTION OF THE SOFTWARE CONSTITUTES YOUR ASSENT TO AND ACCEPTANCE OF THIS EULA. WRITTEN OR ELECTRONIC APPROVAL IS NOT A PREREQUISITE TO THE VALIDITY OR ENFORCEABILITY OF THIS EULA AND NO SOLICITATION OF SUCH WRITTEN OR ELECTRONIC APPROVAL WILL BE CONSTRUED AS AN INFERENCE TO THE CONTRARY. IF YOU DO NOT AGREE TO THE TERMS OF THIS EULA, DO NOT USE THE SOFTWARE AND CONTACT THE PLACE OF PURCHASE FOR A REFUND.
GENERALLY
The software accompanying this EULA, whether delivered on disk, on CD, via electronic download, or on any other physical or electronic media (collectively the "Software") are licensed, not sold, to you. You own the media on which the Software is recorded but Company and/or its licensor(s) retain title to the Software. Similarly, the user guides for installation and use of the Software that the Company makes generally available ("Documentation") are protected by copyright and licensed, not sold, to you. All right, title, and interest in and to the intellectual property rights in the Software and Documentation (and any derivative works of either) not expressly granted to you by this EULA remain with the Company. You do not acquire any other rights, express or implied, in the foregoing other than those rights expressly granted under this EULA.
LICENSE
Subject to your compliance with the terms and conditions of this EULA, the Company grants you a limited, personal, nontransferable and nonexclusive license (without the right to sublicense): (i) to use a single copy of the Software solely for your own internal business operations on a single computer or digital device for production operation or, on a temporary basis, on a backup system if such computer is inoperative, consistent with the limitations specified or referenced in this EULA; (ii) to use the Documentation in support of your authorized use of the Software; and (iii) to make one (1) copy of the Software in machine-readable form for backup purposes only, provided that you will retain on such backup copy all titles and trademark, copyright and restricted rights notices contained on the original.
If you have obtained any Software on a free, discounted or trial basis, your use may be terminated, restricted or limited to certain features or components of the Software in the event that you do not pay for a registration or serial number as set forth in written instructions that the
http://my.smithmicro.com
79
Company provides with such Software. In addition, the Company may terminate or revoke your license to use such Software at any time if you do not obtain an authentic registration or serial number in accordance with such instructions.
RESTRICTIONS
Except as permitted by applicable law and this EULA, you will not use, copy, modify, distribute, or create derivative works from the Software or Documentation or transfer the Software or Documentation, and you will not (and will not permit any third party to) decompile, reverse engineer, disassemble, rent, lease, or loan the Software. You may, however, transfer your rights under this EULA provided you transfer the related Documentation, this EULA and a copy of the Software to a party who agrees to accept the terms of this EULA and provided you destroy all copies of the Software (or portions thereof) remaining in your possession. In addition, you may transfer your rights under this EULA solely in accordance with any written instructions that the Company provides in connection with the Software.
You agree to use the Software and Documentation only for lawful purposes. Any use of the Software or Documentation other than as granted in this EULA must be approved by the Company's prior written consent. The Company maintains an ongoing EULA enforcement program. Violation of any provision in this EULA automatically terminates this EULA. The Company reserves all other rights that it may have for violation of this EULA.
SOFTWARE UPDATES
Company has no obligation to provide support, maintenance, updates, upgrades, modifications, or new releases under this EULA. If Company chooses to make updates to the Software available to you, such updates shall be deemed included within the Software subject to this EULA.
TERMINATION
This EULA remains in full force and effect until terminated. Your rights under this EULA will terminate automatically without notice if you fail to comply with any term(s) of this EULA. Upon termination of this EULA, you will cease all use of the Software and return to Company or destroy the Software and all Documentation in your possession, and so certify to Company. Except for the license granted herein (which shall terminate) and except as expressly provided otherwise herein, the terms of this EULA will survive termination.
CONFIDENTIAL DISCLOSURE
This Software contains trade secrets and proprietary know-how belonging to the Company and it is being made available to you in strict confidence. Any use or disclosure of this Software, or its algorithms, protocols, or interfaces, other than in strict accordance with this EULA, may be actionable as a violation of the Company's trade secret rights.
http://my.smithmicro.com
80
DISCLAIMER OF WARRANTY ON SOFTWARE
YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT USE OF THE SOFTWARE IS AT YOUR SOLE RISK. THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND AND THE COMPANY, ITS SUPPLIERS, DISTRIBUTORS AND LICENSORS EXPRESSLY DISCLAIM ALL WARRANTIES AND/OR CONDITIONS, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES AND/OR CONDITIONS OF TITLE, NON-INFRINGEMENT OF THIRD PARTY RIGHTS, MERCHANTABILITY OR SATISFACTORY QUALITY AND FITNESS FOR A PARTICULAR PURPOSE. THE COMPANY DOES NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE WILL BE CORRECTED. FURTHERMORE, THE COMPANY DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE OR DOCUMENTATION IN TERMS OF THEIR CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY THE COMPANY OR ANY AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU (AND NOT THE COMPANY OR ANY AUTHORIZED REPRESENTATIVE) ASSUME THE ENTIRE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. SOME JURISDICTIONS DO NOT ALLOW THE DISCLAIMER OF IMPLIED WARRANTIES, SO THE DISCLAIMER OF IMPLIED WARRANTIES ABOVE MAY NOT APPLY TO YOU, IN WHICH CASE THE DURATION OF ANY SUCH IMPLIED WARRANTIES IS LIMITED TO SIXTY (60) DAYS FROM THE DATE YOU FIRST INSTALLED THE SOFTWARE ON YOUR COMPUTER; PROVIDED, HOWEVER, THAT YOUR SOLE AND EXCLUSIVE REMEDY, AND COMPANY'S SOLE OBLIGATION SHALL IN ANY CASE BE THAT COMPANY WILL, AT ITS OPTION, REPAIR OR REPLACE YOUR COPY OF THE SOFTWARE, OR TERMINATE THIS EULA AND REFUND AMOUNTS ALREADY PAID THEREFOR BY YOU.
LIMITATION OF LIABILITY
REGARDLESS OF WHETHER ANY REMEDY SET FORTH HEREIN FAILS OF ITS ESSENTIAL PURPOSE OR OTHERWISE, TO THE EXTENT PERMITTED BY LAW, COMPANY, ITS SUPPLIERS, DISTRIBUTORS AND LICENSORS WILL NOT BE LIABLE FOR ANY INDIRECT, EXEMPLARY, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES OF ANY CHARACTER, INCLUDING BUT NOT LIMITED TO DAMAGES FOR COMPUTER MALFUNCTION, LOSS OF INFORMATION, LOST PROFITS AND BUSINESS INTERRUPTION, AND THE COST TO OBTAIN SUBSTITUTE SOFTWARE, ARISING IN ANY WAY OUT OF THIS AGREEMENT OR THE USE OF (OR INABILITY TO USE) THE SOFTWARE HOWEVER CAUSED AND WHETHER ARISING UNDER A THEORY OF CONTRACT, TORT OR ANY OTHER LEGAL THEORY, EVEN IF COMPANY, ITS SUPPLIERS, DISTRIBUTORS OR LICENSORS WAS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THIS LIMITATION MAY NOT APPLY TO YOU. IN NO EVENT SHALL THE COMPANY'S TOTAL LIABILITY TO YOU EXCEED THE AMOUNT PAID BY YOU HEREUNDER.
EXPORT LAW ASSURANCES
http://my.smithmicro.com
81
Export, re-export of this Software is governed by the laws and regulations of the United States and import laws and regulations of certain other countries. You will comply with all such laws and regulations. Export or re-export of Software to any entity on the Denied Parties List and other lists promulgated by various agencies of the United States Federal Government is strictly prohibited.
U. S. GOVERNMENT END USERS
The Software is provided with RESTRICTED RIGHTS. Any use, modification, reproduction, release, performance, display or disclosure by the U.S. Government or any of its agencies shall be governed solely by the terms of this EULA and shall be prohibited except to the extent expressly permitted by the terms of this EULA. The Software and Documentation are deemed to be “commercial computer software” and “commercial computer software documentation”, respectively, pursuant to DFAR Section 227.7202 and FAR 12.212(b), as applicable. Any technical data provided that is not covered by the above provisions is deemed to be “technical data-commercial items” pursuant to DFAR Section 227.7015(a). Any use, modification, reproduction, release, performance, display or disclosure of such technical data shall be governed by the terms of DFAR Section 227.7015(b).
MISCELLANEOUS
This EULA shall be governed by the laws of the United States and the State of California, except for its conflicts of laws principles. This EULA will not be governed by the United Nations Convention on Contracts for the International Sales of Goods, the application of which is expressly excluded. You agree to submit to the exclusive jurisdiction and venue of the state and/or federal courts of Orange County, California with respect to any suit arising out of or relating to this EULA. If for any reason neither the state nor federal courts of Orange County, California exercise jurisdiction over you or such suit, jurisdiction for such suit will be in any court of competent jurisdiction. If for any reason a court of competent jurisdiction finds any provision, or portion thereof, to be unenforceable, the remainder of this EULA shall continue in full force and effect. The waiver by either party of any default or breach of this EULA will not constitute a waiver of any other or subsequent default or breach. Except as expressly provided for in this EULA, you may not assign, sell, transfer, delegate or otherwise dispose of, whether voluntarily or involuntarily, by operation of law or otherwise, this EULA or any rights or obligations under this EULA. Any purported assignment, transfer or delegation by you except as expressly provided for in this EULA will be null and void. This EULA constitutes the entire agreement between the parties with respect to the subject matter herein and supersedes all prior or contemporaneous agreements or representations, written or oral, concerning such subject matter. No amendment to or modification of this EULA will be binding unless in writing and signed by a duly authorized representative of each party.
CONTACT INFORMATION
If you have questions concerning this EULA or need to contact Customer Service, please refer to http://my.smithmicro.com or contact Company at: Smith Micro Software, Inc., 51 Columbia, Aliso Viejo, CA 92656.
http://my.smithmicro.com
82
INTELLECTUAL PROPERTY NOTICES
The Smith Micro Software logo, StuffIt, StuffIt Deluxe, StuffIt SEA Maker, StuffIt Archive Manager, Magic Menu, StuffIt Contextual Menu, StuffIt Expander and DropStuff, the StuffIt Logo, and StuffIt X are trademarks or registered trademarks of Smith Micro Software, Inc. US Patent Numbers 7,184,603 and 7,397,959. JPEG compression technology is patent pending.Copyright (c) 2002 - 2008 Smith Micro Software, Inc. All Rights Reserved. Other brand and product names are the trademarks or registered trademarks of their respective owners.
Version 20080908
http://my.smithmicro.com
83
AppendixH:Misc
Patents Covered by US Patents 7,397,959 and 7,184,603. Additional patents pending.
Copyright Copyright © 2000 - 2008, Smith Micro Software, Inc. All Rights Reserved.