Readme for lion-ftpd-enable version 1.2 11/4/2011 ---------------------------------------------------------------------------------------------------- These Applescript apps were created beginning on August 13, 2011 by Jeff Kendall. I made this when I found out the scan to ftp feature on my Brother printer stopped working since I upgraded to OS X 10.7 Lion. I hadn't noticed because I rarely scan documents. I found instructions on the net but I realized the majority of OS X users don't want to go digging around in the terminal and especially don't want to deal with sudo. Version 1.2: Version 1.2 takes a different approach to enabling and disabling ftpd. By using launchctl, ftpd is enabled but not left running all the time as if it were an application. Starting with v1.2 if ftpd is enabled, the enable menu item is missing and vice versa. Starting with version 1.2, the ftp address of your machine is part of the tool tip as well as part of the first (greyed out) menu pick. The about box is changed as well. If you are running a beta version, there is a link to beta instead of a link to help. Lastly, starting with version 1.2, the app checks for its own updates and will inform you if an update is available. Version 1.0: Starting with Version 0.45 (now 1.0) there is one app that is a menubar application. It is implemented as a Cocoa Applescript application with most of the code in Applescript and some code in Objective C. Menubar Icon: The ftpd-enable menubar icon is a red locked padlock when ftpd is not running and a green unlocked padlock when ftpd is running. If ftpd actually starts running, the icon will turn yellow and remain yellow for about 30 seconds after the active ftpd session ends. It is normal for the icon to be yellow when ftpd-enable launches because an ftp session is used to test ftpd (to avoid forcing the user to enter an admin login just to find out if ftpd is enabled or not). Start by launching ftpd-enable.app. You should see an icon in the menubar. It might start out as a red padlock and switch to green once the app verifies that ftpd was already running. To enable or disable ftpd, click the menubar icon to reveal the menu to control the state of ftpd. Don't worry about whether ftpd is running when you pick "enable ftpd". The app first checks to see if it is running before possibly starting up another instance. The same is true for disable. The app checks to see if it is running and only kills ftpd if it is found to be running. It is still necessary to enter your password to actually enable or disable ftpd. If you enter your password, the app will remember it for "a while" but you will have to enter it again if you decide to enable or disable ftpd "later." Menubar Icon Menu: Click the icon and you get a menu. ** The first menu pick is greyed out and lets you know whether ftpd is running or not. ** The second menu picks is to enable ftpd (if ftpd is not already enabled). ** The second menu picks is to disable ftpd (if ftpd is already enabled). ** The third menu pick brings up the about dialog which goes away if you don't click anything for 15 seconds. The dialog includes "Help" "Donate" and "Dismiss" buttons. The help button takes you to the troncept.com ftpd-enable help pages and the donate button takes you to troncept.com's paypal donate page. ** The last menu pick quits the app and removes the ftpd-enable icon from your menu bar. Donate Button: Starting with version 1.0 there is a Paypal donate button in the about dialog. You don't need a Paypal account to donate. Login Item: Ftpd-enable can now be run as a login item but it is still necessary to enter your password to enable ftpd if it is not running or disable ftpd when it is running. ---------------------------------------------------------------------------------------------------- Older Versions: Version 0.3: Starting with version 0.3 there is only one app to enable or disable ftpd. Run the app and if ftpd is running, the app offers to disable it. If ftpd is not running, the app offers to enable it. Version 0.2: Starting with version 0.2, the enable app checks to see if ftpd is already running before launching it and the disable app checks to see if ftpd is running before disabling it. Self dismissing dialog boxes and online help is added. Added readme file. With older versions, you had to remember to run the ftpd-enable app again when you were done "scanning to ftp" and pick "disable" as this prevents you leaving ftpd running which is a security concern and is the reason Apple took out this feature in Lion to begin with. ---------------------------------------------------------------------------------------------------- Shell Commands: The commands in this script can be run by hand in terminal. They are: To enable ftpd: sudo /bin/launchctl load -w /System/Library/LaunchDaemons/ftp.plist To disable ftpd: sudo /bin/launchctl unload -w /System/Library/LaunchDaemons/ftp.plist Old Command To Run ftpd: sudo /usr/libexec/ftpd -D Old Command To Stop ftpd: sudo killall ftpd ---------------------------------------------------------------------------------------------------- For more info go to http://www.troncept.com/lion-ftpd-enable Requirements: * Intel Mac running OS X 10.7 Lion * Properly configured /private/etc/ftpusers and /private/etc/ftpd.conf (These are already there if you ever enabled ftp server under Snow Leopard and upgraded to Lion) * Must be run by Admin user. * Must enter admin user password to actually enable or disable the ftpd server. Version History: v1.2 11/4/2011 Release update. Complete rewrite to use launchctl. v1.1 10/24/2011 Release update. Added language support for Chinese, French, German, Italian, Japanese, Russian and Spanish. Improved icon. v1.0 10/1/2011 Release Version. Cocoa Applescript application with menubar icon v0.3 8/23/2011 Bug fixes, single app to enable/disable ftpd v0.2 8/14/2011 Bug fixes, dialog box v 0.1 8/13/2011 Initial Release