Changes
rvv
{{/flash}}
[[Image:FMenu-main.png|thumb|400px|Screenshot of FMenu]]
[[Image:Fmenu-prefs.png|thumb|400px|Screenshot of FMenu prefs window]]
'''FMenu''' is a program for [[w:Mac OS X|Mac OS X]] and [[w:Facebook|Facebook]] that sits in the menu bar (near the clock) and provides notifications about various events. In addition, it provides a menu to easily access common Facebook pages and keeps a count of your messages, pokes, events, friend requests, wall posts, and photo comments. It also features a "Quicklaunch" box which gives you immediate access to your friends' profiles, groups, and events, as well as Facebook searches (type a phrase and press enter). Notifications are issued using [[w:Growl|Growl]] and can be customized to the user's liking (including turning on/off and customizing display style). They are:
*A friend updated his profile
*A friend changed his status
*A friend wrote a new note
*Someone wrote on your wall
*You have new messages
*You have new pokes
*You have new friend requests
FMenu checks for updates by default every 7 seconds (or at whatever interval you set), but checks for each kind of notification (friend details, friend requests, wall, messages/pokes, events) separately. Consequently each particular type of notification is refreshed once every 42 seconds.
'''Please note:''' this application will work with most of your friends. However, if you are not getting notifications for some friends, it probably means that they have opted out of releasing their info to applications using the Facebook API. Tell your friends to go to [http://www.facebook.com/settings/?tab=privacy§ion=applications&field=friends_share Facebook's Applications & Websites privacy settings] and make sure that the checkbox labeled ''Status updates'' is '''checked'''. Otherwise, FMenu has absolutely no way of retrieving that user's profile.
==Download==
{{/buttons}}
The latest version is {{/version}}. It is a [[w:Universal Binary|Universal Binary]] and requires Mac OS X 10.4 or better. Note that since version 3.1, there are separate downloads for users of Mac OS X 10.4 and 10.5 and above, due to 64-bit loading issues with Growl. However, there is no functional difference between the versions. The 10.5 and above binary is 64-bit and fully compatible with Snow Leopard.
*FMenu for users of [{{/latestversion/10.4}} 10.4 only] and [{{/latestversion/10.5}} 10.5 and above] who ''already have Growl installed on their system'' (.zip file)
*[{{/3.0/Growl}} FMenu for all other users] – if you do not have Growl installed, FMenu will prompt you to install it automatically with no additional downloads required (.zip file). Note that this is version 3.0; after installation of Growl, check for updates in the menu to update to the latest version.
FMenu is released under the [http://www.gnu.org/licenses/gpl.html GNU General Public License]. Source code can be found inside the application package by going to <tt>FMenu.app/Contents/Resources/Source</tt> or checked out using [[w:Subversion (software)|SVN]] [http://sourceforge.net/svn/?group_id=188286 from SourceForge].
Older versions can be obtained below; however, they are unsupported, generally inferior, and only provided for archival purposes.
==Installation==
Simply download the appropriate file above, then double-click it. FMenu.app will appear in the same folder as the .zip file you just downloaded. Move FMenu.app to your Applications and double-click it to open. You might also want to add it to your startup items by going to System Preferences→Accounts, selecting your account on the left, then clicking on the '''Login items''' tab. Click the '''+''' button and choose FMenu from the window that appears.
As of version 2.5, you can have your Facebook credentials saved by checking the according checkbox on the login page. Note that FMenu does not store your actual password and that this procedure does '''not''' compromise the security of your Facebook account in any way.
==Acknowledgments==
This application completely relies on [http://pointlesscrap.net/mkabefook/ MKAbeFook framework] written by Mike Kinney to communicate with the [http://developers.facebook.com/documentation.php Facebook API]. In addition, the first version of the app was written by Logan Rockmore of [http://www.burgundylogan.com Logan Design].
==Known issues==
*If you put your computer to sleep for an extended period of time, FMenu will obviously give a large number of notifications that happened during the time that your computer was turned off the first time it updates. Make sure that the number of "sticky" notifications is not very high, because otherwise you will spend a lot of time dismissing all of them (Workaround: Alt-click on any growl notifications's close (X) button to dismiss all the messages on-screen).
*If you remove a friend while FMenu is running (or a friend disables their account, etc), you will get a notice saying they changed their profile and published a note.
*If you change your Facebook password, you will stop receiving notifications. Choose Log out… from the menu and then log back in to resume receiving notifications.
There is also a [[/FAQ|FAQ]] of common questions and problems. If you have other questions or problems, please follow the instructions on the [[Talk:{{PAGENAME}}|discussion page]].
==Version history==
{{/changelog}}
{{cs projects}}
