Maemo Wiki Mirror - User contributions [en]

Using Fremantle widgets

2009-06-26T18:50:22Z

88.73.191.60:

This document should help developers to port the user interface from Diablo to Fremantle. The official hildon documentation and the HIG are still quiet thin. Therefore the document mirrors what was discussed on the mailing lists, forum and bug reports. It is based completely on the Fremantle Beta SDK which is the most recent SDK at the moment.

Please feel totally free to add/update/change/remix this document. Many aspects are currently not discussed here but will hopefully be added by you!

Note: The casts of all code examples haven been removed for better readability.

= Toggle Buttons Vs. Radio Buttons =
The use of radio buttons in Fremantle is discouraged because they don't fit the visual style quite well. Instead you should use toggle buttons.

So if you need the behavior of radio buttons (which is that only one can be selected at a time) simply create them as usually and then call <code>gtk_toggle_button_set_mode()</code>. This will create a button that acts like a radio button, but is displayed as a toggle button.

Example:
<pre>
GtkWidget *b1 = gtk_radio_button_new_with_label("One");
GtkWidget *b2 = gtk_radio_button_new_with_label_from_widget(b1, "Two");
gtk_toggle_button_set_mode(b1, FALSE);
gtk_toggle_button_set_mode(b2, FALSE);
</pre>

[[Image:Fle_tut_radio_buttons.jpg|frame|Above you see how radio buttons are displayed in Fremantle. There is a bug in this screenshot, normally of course only one of the four options would be selected.]]

[[image:Fle_tut_toggle_buttons.jpg|frame|Here you can see four radio buttons which are displayed as toggle buttons using the <code>gtk_toggle_button_set_mode()</code> function mentioned above.]]

= Widget Sizes =
For some widgets there is now an enum which provides three different values: <code>HILDON_SIZE_FINGER_HEIGHT</code>, <code>HILDON_SIZE_THUMB_HEIGHT</code> and <code>HILDON_SIZE_AUTO_HEIGHT</code>. You can use them, for example, like that:
<pre>
GtkWidget but* = hildon_gtk_button_new(HILDON_SIZE_FINGER_HEIGHT);
</pre>
You should always use the finger or the thumb size, don't use HILDON_SIZE_AUTO_HEIGHT as the outcome is not totally clear (see below for screenshots).

If you have a button where you cannot provide a size with the constructor, for example, a stock button, then you can use <code>hildon_gtk_widget_set_theme_size()</code> to set the code afterwards. Like in this small example:
<pre>
GtkWidget *but = gtk_button_new_from_stock(GTK_STOCK_COPY);
hildon_gtk_widget_set_theme_size(but, HILDON_SIZE_THUMB_HEIGHT);
</pre>

Now to get a feeling for the different sizes here are some screenshots that show a HildonEntry together with a GtkButton using different sizes.

[[Image:Fle_tut_button_auto_finger.jpg|frame|A HildonEntry with HILDON_SIZE_AUTO_HEIGHT and a GtkButton with HILDON_SIZE_FINGER_HEIGHT. Looks inconsistent.]]

[[Image:Fle_tut_button_finger_finger.jpg|frame|Both widget with HILDON_SIZE_FINGER_HEIGHT. Looks more consistent now.]]

[[Image:Fle_tut_button_finger_thumb.jpg|frame|For comparison reasons the HildonEntry with HILDON_SIZE_FINGER_HEIGHT and the GtkButton with HILDON_SIZE_THUMB_HEIGHT.]]

= Window Menu =
In Fremantle it is not encouraged to use <code>GtkMenu</code> as window menu anymore. Instead you should use the <code>HildonAppMenu</code>. This new menu is really different from the old one so it´s worth taking a closer look. Here are the main features of the HildonAppMenu.
* It has big / finger friendly menu items.
* It holds a maximum of ten menu items.
* It does not support sub menues.
* The first row can be used for Filters. (Filters are explained in more details below.)
* In landscape mode the menu items are displayed in two rows.
* In portrait mode the menu items are automatically displayed in one row.
* There are no separators, so you cannot group your menu items.
* The menu items are GtkButtons and not GtkMenuItems.

The HildonAppMenu is meant to be displayed when the user clicks the title bar of the window, but it is possible to have several other HildonAppMenus in your application and activate them for example on button press.

As you can see the HildonAppMenu differs quite a lot from the old GtkMenu. The main difference is surely that you cannot have more then 10 menu items
inside the new menu. The Hildon HIG gives an overview on how to deal with that.

[[Image:Fle_tut_app_menu_with_filters.jpg‎|frame|A HildonAppMenu with two filters at the top and four buttons]]

== Using HildonAppMenu with GtkActions ==
As said earlier, the menu items are no GtkMenuItems anymore but instead they are normal GtkButtons. So you´re using GtkActions in your code, you´ll probably miss a replacement for <code>gtk_action_create_menu_item()</code>. There is no direct replacement, instead you just have to use standard gtk functions to connect the button as a proxy to the action. Here is an example:
<pre>
GtkButton *menu_item = gtk_button_new();
gtk_action_connect_proxy(action, menu_item);
</pre>
This is also possible with <code>GtkToggleAction</code> and <code>GtkRadioAction</code>. But remember that your GtkRadioButtons should look like GtkToggleButtons as mentioned above. So a complete example for a HildonAppMenu that should display three GtkRadioActions would look like this:

<pre>
GSList *group = NULL;
GtkAction *a1, *a2, *a3;
GtkWidget *b1, *b2, *b3;
GtkWidget *menu;

/* Create the actions */
a1 = gtk_radio_action_new("small", "Small", NULL, NULL, 0);
a2 = gtk_radio_action_new("normal", "Normal", NULL, NULL, 1);
a3 = gtk_radio_action_new("large", "Large", NULL, NULL, 2);

/* Build the radio action group */
gtk_radio_action_set_group(a1, group);
group = gtk_radio_action_get_group(a1);

gtk_radio_action_set_group(a2, group);
group = gtk_radio_action_get_group(a2);

gtk_radio_action_set_group(a3, group);
group = gtk_radio_action_get_group(a3);

/* Create the toggle buttons */
b1 = gtk_toggle_button_new();
b2 = gtk_toggle_button_new();
b3 = gtk_toggle_button_new();

/* Connect the buttons and the actions */
gtk_action_connect_proxy(a1, b1);
gtk_action_connect_proxy(a2, b2);
gtk_action_connect_proxy(a3, b3);

/* Create the menu */
menu = hildon_app_menu_new();

/* Add the buttons to the menu */
hildon_app_menu_append(menu, b1);
hildon_app_menu_append(menu, b2);
hildon_app_menu_append(menu, b3);
</pre>

= Finger Friendly GtkTreeView =
To get a finger friendly <code>GtkTreeView</code> it´s not enough to call <code>hildon_gtk_tree_view_new()</code> instead of <code>gtk_tree_view_new()</code> but you also have to put the tree view inside a <code>HildonPannableArea</code> to get finger friendly sizes. If you have your tree view inside a <code>GtkScrolledWindow</code> it will be displayed with stylus-style (like in Diablo).

Also if you´re displaying icons in your tree view you probably should use the 40x40 pixel version for Fremantle if you used the 26x26 pixel version in Diablo.

== Normal Vs. Edit Mode ==
There are now two different modes for the tree view. Those modes affect how the rows in a tree view react to finger taps.

You should use <code>HILDON_UI_MODE_NORMAL</code> if the user should only be able to activate one row of the text view. If the user taps a row in the tree view the <code>row-activated</code> is emitted. In standard Gtk+ this happens only if the user double clicks the row - a single click selects the row which is not possible with <code>HILDON_UI_MODE_NORMAL</code>.

If the user should be able to select or edit rows then you should use <code>HILDON_UI_MODE_EDIT</code>.

== Using Filters For Sorting ==
Most of you probably are using the tree view with a header row that displays column labels. Often this header row can also be used to sort the columns ascending or descending. If you're designing a finger friendly UI you will usually have a very limited number of visible columns - probably only one or two. In this case the column content is often self explanatory and the header row is only there for sorting. If that's the case for your UI, you might want to remove the header column completely and replace it with so called filters on the HildonAppMenu.

According to the HIG filters are meant to change how data is presented, but it should not affect the amount of data that is displayed. Sorting a tree view would be a possible use case. To do this, just have a look at the example:
<pre>
/* Remove the header row */
gtk_tree_view_set_headers_visible(view, FALSE);

/* Create two radio buttons for sorting */
GtkWidget *b1, *b2;
b1 = gtk_radio_button_new_with_label(NULL, "Sort By Title");
b2 = gtk_radio_button_new_with_label_from_widget(b1, "Sort By Date");

/* Draw them as toggle buttons not as radio buttons */
gtk_toggle_button_set_mode(b1, FALSE);
gtk_toggle_button_set_mode(b2, FALSE);

/* Add the buttons as filters to the menu */
hildon_app_menu_add_filter(menu, b1);
hildon_app_menu_add_filter(menu, b2);
</pre>

That is all for showing them on the window menu. Now only a callback is needed which gets activated whenever the user selects a filter. An example implementation might look like that:
<pre>
void on_sort_filter_clicked(GtkToggleButton *button, GtkTreeSortable *sortable)
{
if (gtk_toggle_button_get_active(button)) {
gtk_tree_sortable_set_sort_column_id(sortable, TITLE_COLUMN, GTK_SORT_ASCENDING);
}
}
</pre>

You can add as many filters as you like, but they will be displayed all in one row and there is no possibility to add another filter row. This means you have to select carefully what to put there and also have a look at the length of the strings.
If you, for example have two rows, one with a title and one with a date you could offer the user:
* Sort ascending by date
* Sort descending by date
* Sort ascending by title
* Sort descending by title
Those four strings will not fit into one row. Therefore you have to make a selection and include only the cases which will (hopefully) be most relevant to the user. In this case you should offer:
* Sort by title (which sorts by title ascending - A before B)
* Sort by date (which sorts by date descending - newest on top)
Limiting options here is even more important if you're planning to use the portrait mode, because there you'll have even less space in that row.

[[Image:Fle_tut_tree_view.jpg‎|frame|A tree view without the title row. Sorting is now done with filters]]

[[Image:Fle_tut_tree_view_filter.jpg‎|frame|When clicking the title bar two filters are shown which let the user sort the tree view]]

[[Image:Fle_tut_filter_long_strings.jpg|frame|Long strings get truncated]]

= Context Menus =
To display finger friendly context menues there is a hildon helper function called <code>hildon_gtk_menu_new()</code>. Just call this instead of <code>gtk_menu_new()</code> and you´re done.
Example:
<pre>
GtkWidget *menu = hildon_gtk_menu_new();

GtkWidget *item1 = gtk_menu_item_new_with_label("Bla");
GtkWidget *item2 = gtk_menu_item_new_with_label("Blablabla");

gtk_menu_shell_append(GTK_MENU_SHELL(menu), item1);
gtk_menu_shell_append(GTK_MENU_SHELL(menu), item2);

gtk_widget_show_all(menu);
gtk_menu_popup(GTK_MENU(menu), NULL, NULL, NULL, NULL, 0,
gtk_get_current_event_time());
</pre>
''Note that in the Beta SDK there is a bug. If you´re using <code>GtkImageMenuItems</code> instead of <code>GtkMenuItems</code> the menu will have stylus-style. This bug is already fixed and a work around is available here: https://bugs.maemo.org/show_bug.cgi?id=4654 .''

[[Image:Fle_tut_context_menu.jpg‎|frame|Finger friendly context menu which is showing four stock items]]

= Panning =
Almost all of you will know the problems with scrollbars in Diablo. You can have small scrollbars which are not finger friendly or you can have large scrollbars which are using a lot of screen space and look ugly.

In Fremantle both kinds of scrollbars are still available, but there is also a third option. <code>HildonPannableArea</code> features kinetic panning using fingers. There is no scrollbar anymore, only a very small scroll indicator that indicates which part of the document you´re seeing right now.
<code>HildonPannableArea</code> can be used as a replacement for <code>GtkScrolledWindow</code> but there are things you have to keep in mind when doing so.

== GtkTextView Inside HildonPannableArea ==
Panning does not work with a <code>GtkTextView</code>. Instead you can use a <HildonTextView> which is a drop in replacement. The advantage is, that then panning is possible. The disadvantage is that selecting text is not possible anymore. The discussion about this is here: https://bugs.maemo.org/show_bug.cgi?id=4619

== GtkHtml Inside HildonPannableArea ==
When using <code>GtkHtml</code> inside a <code>HildonPannableArea</code> the panning is not smooth. The problem seems to be that GtkHtml provides some build in support for panning and that it conflicts with the panning offered by Hildon. See this bug report here: https://bugs.maemo.org/show_bug.cgi?id=4631

= Portrait Mode =
If your application should work in portrait mode you probably have to change the UI quite a bit. There are a couple of problems you'll might have:
* The toolbar is not wide enough to hold all items anymore.
* The columns of your tree view get too small.
* You cannot enter text because there´s no onscreen keyboard.
* Dialogs are not shown correctly (see https://bugs.maemo.org/show_bug.cgi?id=4618 ).
* Probably more...

This means you have to listen to changes in the orientation and hide/show/change widgets to make the UI functional in portrait mode.

[[Image:Fle_tut_app_menu_portrait.jpg|frame|The HildonAppMenu with filters in portrait mode. The final version will cover the complete screen width, so there is a bit more space for the filters.]]

== Listening To Orientation Changes ==
There is no Fremantle specific API for that (yet?), but you can do for example the following:
<pre>
gboolean is_portrait()
{
GdkScreen *screen = gdk_screen_get_default();
int width = gdk_screen_get_width(screen);
int height = gdk_screen_get_height(screen);
if (width > height) {
return FALSE;
} else {
return TRUE;
}
}

void on_orientation_changed(GdkScreen *screen, GtkWidget *widget)
{
if (is_portrait()) {
gtk_widget_hide(widget);
/* Hide/Show other things */
} else {
gtk_widget_show(widget);
/* Hide/Show other things */
}
}
</pre>
Then inside your UI code you should listen to the <code>size-changed</code> signal of <code>GdkScreen</code>. For example:
<pre>
g_signal_connect(screen, "size-changed", on_orientation_changed, widget);
</pre>

== Testing Orientation Changes In Scratchbox ==
For testing your code you can execute the following commands outside scratchbox:
<pre>
xrandr -display :2 -o left
xrandr -display :2 -o normal
</pre>

== Marking Your App As Portrait Capable ==
If your application should automatically rotate when the device is rotated you have to explicitly mark your application as portrait capable. This is not yet implemented in the current beta SDK, but there will be one enum and a function as shown below:
<pre>
typedef enum {
HILDON_PORTRAIT_MODE_REQUEST = 1 << 0,
HILDON_PORTRAIT_MODE_SUPPORT = 1 << 1
} HildonPortraitFlags;

hildon_gtk_window_set_portrait_flags(GtkWindow *window, HildonPortraitFlags flags);
</pre>
The support flag tells Hildon that it is allowed to rotate your application. The request flag directly puts your application into portrait mode. It´s important to note that all visible windows must support portrait mode, otherwise the screen is not rotated.

= References =
In no particular order

* http://maemo.org/api_refs/5.0/beta/tutorial/html
* http://maemo.org/api_refs/5.0/beta/hig/html

* http://lists.maemo.org/pipermail//maemo-developers/2009-May/019368.html
* http://lists.maemo.org/pipermail//maemo-developers/2009-May/019144.html
* http://lists.maemo.org/pipermail//maemo-developers/2009-June/019426.html
* http://lists.maemo.org/pipermail//maemo-developers/2009-June/019579.html

* https://bugs.maemo.org/show_bug.cgi?id=4617
* https://bugs.maemo.org/show_bug.cgi?id=4618
* https://bugs.maemo.org/show_bug.cgi?id=4619
* https://bugs.maemo.org/show_bug.cgi?id=4654
* https://bugs.maemo.org/show_bug.cgi?id=4637
* https://bugs.maemo.org/show_bug.cgi?id=4648

Fremantle Stars/Conboy

2009-06-25T20:03:33Z

88.73.191.60:

== Current version ==
Current version can be found [http://repository.maemo.org/extras-devel/pool/fremantle/free/c/conboy here].

== Features in latest release ==
* Text formattings like bold, italic, small, big, etc.
* Automatic saving of all changes (including cursor position)
* Bullet lists with unlimited depth.
* Linking notes with other notes
* Automatically link to existing notes while you type
* Automatically create bullet lists if a line starts with a dash (-) or an asterix (*)
* Search inside a single note
* Search over all note titles
* Notes are stored in the Tomboy note format. So they are compatible with Tomboy, GNote and Tomdroid
* Support for full screen (via hardware button)
* Zooming note content (via hardware buttons)
* Last edited note shown on startup
* Integrated with Maemo-Backup

== Ready but waiting for release ==
* UI completely adapted to Fremantle
* Supports portrait mode on Fremantle for reading and selecting notes (not for writing)
* Full-text search over all notes

== Planned and started ==
* Integration with Tracker on Fremantle
* Synchronize with Snowy (Tomboys online note service)
* Implement support for different storage backends (e.g. directly saving to the cloud)

== Planned but not started (people please step forward) ==
* Automatically link to web pages, email addresses, phone numbers, etc.
* Add a home screen applet
* Support for notebooks (collection of notes)
* Send note via E-Mail
* Send note via Bluetooth
* Undo and Redo
* D-Bus API
* Backlinks (aka "What links here")
* Support for text snippets and templates

Fremantle Stars/Conboy

2009-06-18T18:29:41Z

88.73.191.60: /* Features in latest release */

== Current version ==
Current version can be found [http://repository.maemo.org/extras-devel/pool/fremantle/free/c/conboy here].

== Features in latest release ==
* Text formattings like bold, italic, small, big, etc.
* Automatic saving of all changes (including cursor position)
* Bullet lists with unlimited depth.
* Linking notes with other notes
* Automatically link to existing notes while you type
* Automatically create bullet lists if a line starts with a dash (-) or an asterix (*)
* Search inside a single note
* Search over all note titles
* Notes are stored in the Tomboy note format. So they are compatible with Tomboy, GNote and Tomdroid
* Support for full screen (via hardware button)
* Zooming note content (via hardware buttons)
* Last edited note shown on startup
* Integrated with Maemo-Backup

== Ready but waiting for release ==
* UI completely adapted to Fremantle
* Supports portrait mode on Fremantle for reading and selecting notes (not for writing)

== Planned and started ==
* Integration with Tracker on Fremantle
* Synchronize with Snowy (Tomboys online note service)
* Implement support for different storage backends (e.g. directly saving to the cloud)

== Planned but not started (people please step forward) ==
* Full-text search over all notes
* Automatically link to web pages, email addresses, phone numbers, etc.
* Add a home screen applet
* Support for notebooks (collection of notes)
* Send note via E-Mail
* Send note via Bluetooth
* Undo and Redo
* D-Bus API
* Backlinks (aka "What links here")
* Support for text snippets and templates

Fremantle Stars

2009-06-16T10:15:37Z

88.73.191.60:

== Status of Fremantle Stars and other great apps ==

You have an interesting Fremantle project. You want to have it ready by the Maemo 5 final release. You are willing to get help and promotion from Nokia. List your project here with the current status and the related links.

[http://maemo.org/news/announcements/0eb8fdfeedec11ddb28e1b3c4d7b308a308a/ Fremantle Stars] projects are encouraged to report here, but any other project can join as well. If your project rocks we will help you as well.

* Roadmap - A list of features and improvements planned for Fremantle, so everybody gets an idea on what to expect and what to look for when testing[http://talk.maemo.org/showpost.php?p=296871&postcount=33]
* [http://wiki.maemo.org/Bugs:Adding_Extra_products HOWTO: Adding your product to bugs.m.o]
* '''-devel''' means [http://repository.maemo.org/extras-devel/pool/fremantle/ Extras-Devel for Fremantle] (Upload via [https://garage.maemo.org/extras-assistant/ Extras Assistant])
* maemo-testing doesn't exist yet [http://talk.maemo.org/showpost.php?p=295552&postcount=8]
* Extras - also does not exist yet
* Downloads means you have a proper page at http://maemo.org/downloads [http://talk.maemo.org/showpost.php?p=295552&postcount=8]
* Showstoppers - Major problems blocking your development progress. If you need help from others shout here.

{| class="wikitable"
| style="background:LightGreen" | Mission complete!
| style="background:LightBlue" | Beta in progress
| style="background:Gold" | Too alpha
| style="background:Crimson" | Broken, can't test
| | Missing, can't evaluate
|}

{| class="wikitable sortable"
|-
! Project
! Roadmap
! bugs.m.o
! -devel
! -testing
! extras
! Downloads
! Showstoppers
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/ecoach eCoach] || - ||[https://bugs.maemo.org/enter_bug.cgi?product=eCoach Yes]||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/e/ecoach/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/ecoach/ Yes] || Can't get fix. Seems not to get location data available.
|- style="background:LightGreen"
| [http://maemo.org/downloads/product/OS2008/enigma Enigma] || done || | No ||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/e/enigma/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/enigma/ Yes] || Fully functional incl. accelerometer
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/fbreader FBReader] || - || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/f/fbreader/ Yes] || ? || ? || ? || libfribidi0 missing due to SDK/image inconsistency
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/liqbase liqbase] || [http://wiki.maemo.org/Fremantle_Stars/liqbase yes] || soon || yes || ? || asap || asap || packaging broken and layout styling
|-
| [http://maemo.org/downloads/product/OS2008/mauku Mauku] || - || ? || ? || ? || ? || ? || -
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/numptyphysics NumptyPhysics] || - || ? || ? || ? || ? || ? || Wrong startup and seems that touch events are wrongly registered
|- style="background:Crimson"
| [http://maemo.org/downloads/product/OS2008/omweather OMWeather] || - || [https://bugs.maemo.org/enter_bug.cgi?product=OmWeather Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/o/omweather/ Yes] || ? || ? || ? || No way to add a new station. There was a separate package for sources before, not now.
|- style="background:Gold"
| [http://maemo.org/downloads/product/OS2008/osm2go OSM2Go] || Next step: Automatically pre-installed test projects || |[https://bugs.maemo.org/enter_bug.cgi?product=osm2go Yes]||
[http://repository.maemo.org/extras-devel/pool/fremantle/free/o/osm2go/ Yes]
|| - || - || [http://maemo.org/downloads/product/OS2008/osm2go/ Yes] || GPS functionality can't be tested in beta SDK
|-
| [http://maemo.org/downloads/product/OS2008/vagalume Vagalume] || No || Soon || No || ? || ? || [http://maemo.org/downloads/product/OS2008/vagalume Yes] || -
|- style="background:Gold"
| [http://maemo.org/downloads/product/OS2008/gpodder gPodder] || [[Fremantle Stars/gPodder|Yes]] || [https://bugs.maemo.org/enter_bug.cgi?product=gPodder Yes] || [http://repository.maemo.org/extras-devel/pool/fremantle/free/g/gpodder/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/gpodder Yes] || Seems to work. Missing roadmap to check against current app.
|-
| [https://garage.maemo.org/projects/easy-deb-chroot/ Easy Debian] || - || no || no || - || - || [http://maemo.org/downloads/product/OS2008/easy-deb-chroot Yes] || (Need some binaries in place, will post soon)
|- style="background:Gold"
| [https://garage.maemo.org/projects/conboy Conboy] || [http://wiki.maemo.org/Fremantle_Stars/Conboy Yes] || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/c/conboy/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/conboy Yes] || Seems to work.
|-
| [http://maemo.org/downloads/product/OS2008/bluemaemo/ BlueMaemo] || [http://www.valeriovalerio.org/?page_id=174 Yes] || [https://bugs.maemo.org/enter_bug.cgi?product=BlueMaemo Yes] || no || - || - || [http://maemo.org/downloads/product/OS2008/bluemaemo/ Yes] || None known atm
|-
| [http://maemo.org/downloads/product/OS2008/pwsafe/ PasswordSafe] || No || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/p/pwsafe/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/pwsafe/ Yes] || None known atm
|-
| [http://maemo.org/downloads/product/OS2008/tabletbridge/ TabletBridge] || [http://tabletsb.garage.maemo.org/ Yes] || No || [http://repository.maemo.org/extras-devel/pool/fremantle/free/t/tabletbridge/ Yes] || - || - || [http://maemo.org/downloads/product/OS2008/tabletbridge/ Yes] || -
|-
| [http://openbossa.indt.org/canola Canola] || - || [https://bugs.maemo.org/enter_bug.cgi?product=Canola Yes] || No || - || - || [http://maemo.org/downloads/product/OS2008/canola2 Yes] || Currently building packages for dependencies.
|-
| (name linked to project) || Y/N link || Y/N || Y/N || Y/N || Y/N || Y/N || Y/N link to news
|}

== Proposals for Fremantle Stars ==
Nokia wants to support application developers having third party software ready for prime time by the day Maemo 5 is released. The first action is to select few projects to be supported since the day the first Fremantle SDK is released.

If your project hasn't been selected do not surrender. More actions will come with the beta SDK.

Above you have the applications that were proposd by the community. Nokia picked the projects to be supported from that list.

See also the [[Task:Remarkable_community_projects]] and [[Killer_Apps]].

=== Release quality ===

* [http://maemo.org/downloads/product/OS2008/mauku/ Mauku]: The micro-blogging client for Maemo devices
: Mauku was proposed earlier by someone, but was not available in Extras that time. Now it is, and thus, Mauku fulfills all requirements listed above.
* [http://maemo.org/downloads/product/OS2008/maemopadplus/ Maemopad+]: pressure-sensitive sketching, available in Extras, now in development again with focus on fixing Usability issues and finger-friendliness
*[http://maemo.org/downloads/product/OS2008/maemo-mapper Maemo Mapper] [[Image:Star.png]]: Most downloaded application for Maemo. Best map application. Can interact with lots of different mapping sites, including OpenStreetmap.
*[http://maemo.org/downloads/product/OS2008/numptyphysics Numpty Physics] [[Image:Star.png]]: This game is educational, hard, fun. Made for the stylus.
: Any ideas for features making the most from an Internet connection? Adding (optionally) the online dimension would be phantastic.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: High scores, level/content download, maybe co-op gameplay. —[[User:generalantilles|GeneralAntilles]] 08:48, 24 October 2008 (UTC)
: I've started working on online aspect for NP including level download and submission, demo recording and upload etc though obviously the amount of work to get this up and running, especially on the web side, is not insignificant. Need more levels too. In short, an injection of manpower could get NP polished and shiny but I personally am very short on spare time these days. —[[User:tim_edmonds|Tim]] 08:48, 27 October 2008 (UTC)
* [http://maemo.org/downloads/product/OS2008/scummvm/ ScummVM]: Point-and-click adventures are great for touchscreens, some free-as-in-beer games are available (Beneath a Steel Sky, etc..)
: This is an enabler. A user can't do much twith this alone. What about proposing a specific game (or set of games) using ScummVM? --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: As mentioned above, Beneath a Steel Sky, Flight of the Amazon Queen, etc. —[[User:generalantilles|GeneralAntilles]] 08:50, 24 October 2008 (UTC)
::: The problem with those is that they don't fit well onto device rootfs. Much better would be a Hildonized ScummVM "Content frontend" that would depend from ScummVM, list freely available games/gamedemos (with screenshot etc) and allow user to to launch them with ScummVM. If the game/demo isn't yet in the device, the frontend would first automatically download the required files from the net to a external/internal memory card + setup them for ScummVM. Similar thing would be useful also for other things that have large data sets (like Wesnoth). [Eero Tamminen, 2009-06-11]
* [http://maemo.org/downloads/product/OS2008/gpodder/ gPodder]: Finger-friendly UI, highlights the Internet aspect of the tablets (download podcasts); regular releases, many Maemo-specific UI changes; performance issues are worked on; tablet-related podcasts exist (example: [http://www.talkshoe.com/talkshoe/web/talkCast.jsp?masterId=27204&cmd=tc]) - downloading podcasts directly on the mobile device is a thing that you can with Nokia's tablets and gPodder, but not with iPhone/iPod touch right now
: Needs a much better list of podcasts, possibly the list that the N95 podcast application uses if formats are compatible. I've also had issues with gpodder leaking memory, and making my N810 slow down.--[[User:alan_peery|alan_peery]] 18:09, 31 December 2008 (UTC)
*[http://maemo.org/downloads/product/OS2008/xournal Xournal] [[Image:Star.png]]: A great notes/sketch utility. One of ''few'' apps that utilize the pressure sensitivity of the screen! Invaluable to create and annotate PDF documents on a pocket computer.
* [http://www.pimlico-project.org/index.html Pimlico]: PIM applications
* [http://clay.ll.pl/osmo Osmo]: PIM solution supporting open standards (SyncML, iCal)
* [http://tarot.freeshell.org/leafpad/ Leafpad]: for notes taking (and script programming)
: Too geeky for this call. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
* [http://www.gnome.org/projects/gnumeric/ Gnumeric]: spreadsheet application
: Impressing users with a spreadheet editor? Don't get me wrong, I see the usefulness of the application but we are looking for more shiny things in this call.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
* [http://www.abisource.com/ Abiword]: document editor
: Any thoughts on adding the real time collaborative editing feature? Still, perhaps this is another tool clearly useful but not really impressive for desktop users - nor seems to be taking many advantages of the Maemo 5 features.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: Perhaps it lacks glitz, but it seems to me that an Office-compatible text editor might mean quite a bit to a lot of users (heck, a decent word processor of ''any'' sort is likely to make a lot of people happy). —[[User:generalantilles|GeneralAntilles]] 08:52, 24 October 2008 (UTC)
* [http://pidgin.garage.maemo.org/ Pidgin]: for instant messaging
* [https://addons.mozilla.org/firefox/addon/748 Greasemonkey] support?
: Another enabler. It would be better to have an impressing candidate based on Greasemonkey. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
:: [http://browser-extras.garage.maemo.org/downloads_os2008.html browser-extras for OS2008]
* [http://pymaemo.garage.maemo.org/ PyMaemo]
: PyMaemo is great, but it says nothing per se to users. --[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
*[http://maemo.org/downloads/product/OS2008/maemo-wordpy Maemo WordPy] [[Image:Star.png]]: Blogging software that hooks to WordPress and Blogger accounts, allows image uploads, post creating and editing, tagging. Especially notable for its finger-friendly menu.
* [http://maemo.org/downloads/product/OS2008/quiver/ quiver]: image viewer
* [http://www.fbreader.org/ FBReader]: e-book reader. Great functionality, but the UI is a bit clunky (file dialogs are not Hildonized, preferences dialogs are overwhelmingly complicated, there's no smooth touch scrolling).
: Will need at least one book included, and preferably a link to where to download more. My recommendation for the latter is manybooks.net, where many of the Gutenberg Project books have been reformatted. --[[User:alan_peery|alan_peery]] 18:05, 31 December 2008 (UTC)
* [https://wiki.mozilla.org/Fennec Fennec]: Mozilla Firefox-based browser made specifically for mobile devices & touch screens. Currently (23 oct 2008) in Alpha phase.
* [http://www.v7f.eu/public/n800/chess/ Eboard and crafty chess engine] port of the [http://www.bergo.eng.br/eboard/ eboard] chess program. Main goal is playing on [http://www.freechess.org fics] or other online chess platforms against other human players. Analysis or games vs. engine are possible to. Can handle .pgn files and looks better than the chess "application" which is installed at the tablet after flashing the firmware.
* [http://maemo.org/downloads/product/OS2008/quickclip/ Quick Clip] A statusbar plugin that allows you to save text from any application (or input it directly) into categorized files; also comes with a fairly nifty viewer. Although relatively stable, still very much in active development.
*[http://garage.maemo.org/projects/bluemaemo/ BlueMaemo]: BlueMaemo is a remote controller program for the Maemo-powered devices. Accelerometer controls and a 3d/air mouse are planned for Fremantle.

=== Alpha/Beta quality ===
*[http://maemo.org/downloads/product/OS2008/conboy/ conboy]: A port to Maemo of the Tomboy application, this personal wiki software is great for organizing notes, todos, etc.
*[http://maemo.org/downloads/product/OS2008/osm2go/ osm2go]: This is a tool to '''create''' maps. It makes use of the hirez (touch) screen, a permanent internet connection for up- and download and the GPS of course. No such tool seems to exist for any other mobile plattform.
: Very interesting. Any way to make this a plugin of the very popular Maemo Mapper? Imagine that users would just use the maps, having the ability to go for an "editing mode" by pressing a key.--[[User:qgil|qgil]] 08:14, 24 October 2008 (UTC)
::Sure, that's planned to happen soon. Currently not planned as a plugin (does MM support plugins?) but via dbus interaction to e.g. use the current Maemo-Mapper view as the area to work on. Pretty much like gpxview also interacts with Maemo-Mapper --[[User:harbaum|harbaum]] 12:50, 25 October 2008 (UTC)
::Done --[[User:harbaum|harbaum]] 22:50, 3 November 2008 (UTC)
::A freemantle release of osm2go could use the clutter canvas instead of goocanvas or gnomecanvas. This way it would immediately take advantage of the video accelerator.
*[http://garage.maemo.org/projects/maemo-barcode/ maemo-barcode]: Alpha quality, could be a very cool application with some integration and interface development.
: I've not used maemo-barcode but I see something like this could encompass much more than barcodes. From a hi-res picture you can also extract text and then cross reference it on google. Usually, even a short fragment of text can give a very specific match for example for article text, street signs, names numbers addresses etc, eg: similar to [http://exbiblio.com exbiblio]. Then you can log it and tag it with gps/cell-id and make it all searchable. Of course, this would require a high res camera that doesn't just point at your head. --[[User:tim_edmonds|Tim]]
*[http://garage.maemo.org/projects/liqbase liqbase]: Beta (now in extras) playground for sketching with kinetic graffiti with fullscreen tearfree refresh. finger friendly and FAST. shows off your tablet in the best light.
* Bring [http://garage.maemo.org/projects/gazpacho-maemo/ Gazpacho] back to life
: Developer tools are out of scope in this call.--[[User:qgil|qgil]] 06:35, 23 October 2008 (UTC)
*[http://garage.maemo.org/projects/tear/ Tear]: Beta quality, a WebKit-based browser which aims for better tablet-oriented experience (and maybe cross-engine).
*[http://www.estamos.de/projects/SyncML/index.html syncevolution]: A very powerful application to synchronize the tablets with a SyncML Server. Actually working with the osso-addressbook and pimlico dates.
*[http://maemo.org/downloads/product/OS2008/pwsafe/ PasswordSafe]: Password safe is a utility to keep a list of usernames and passwords encrypted with a single password by Peter Weston. Its file format is from Bruce Schneier's utility of the same name. the UI has been changed to a tree within a pannable area for Fremantle (that's why it's back to Beta in 1.5)

[[Category:Community]]
[[Category:Development]]