Maemo Wiki Mirror - User contributions [en]

Miniature/Development

2011-10-10T21:52:10Z

192.100.106.40: /* Miniature 0.5 release */

{{Miniature}}

Most content of this page has moved to http://miniature-chess.org/
We are waiting to get the BugzillaReports extension running to move the rest.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.5 release ===

Tasks COMMITTED for Miniature 0.5.

{{#bugzilla:id=7867,12345,12351,12359,12390,12394,12419,12420,12426,12435,12455,12456
|columns=id,severity,status,resolution,summary
|sort=resolution,status,severity,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [http://miniature-chess.org/wiki/Wishlist Wishlist].

Miniature/Development

2011-10-10T19:19:17Z

192.100.106.40: /* Miniature 0.5 release */

{{Miniature}}

Most content of this page has moved to http://miniature-chess.org/
We are waiting to get the BugzillaReports extension running to move the rest.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.5 release ===

Tasks COMMITTED for Miniature 0.5.

{{#bugzilla:id=7867,12345,12351,12359,12390,12394,12419,12420,12426,12435,12455,12456
|columns=id,severity,status,resolution,summary
|sort=severity,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [http://miniature-chess.org/wiki/Wishlist Wishlist].

Miniature/Development

2011-10-07T22:24:23Z

192.100.106.40: /* Miniature 0.5 release */

{{Miniature}}

Most content of this page has moved to http://miniature-chess.org/
We are waiting to get the BugzillaReports extension running to move the rest.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.5 release ===

Tasks COMMITTED for Miniature 0.5.

{{#bugzilla:id=7867,12351,12359,12390,12394,12419,12420,12426,12435,12455,12456
|columns=id,severity,status,resolution,summary
|sort=severity,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [http://miniature-chess.org/wiki/Wishlist Wishlist].

Miniature/Development

2011-10-07T22:05:58Z

192.100.106.40: /* Miniature 0.5 release */

{{Miniature}}

Most content of this page has moved to http://miniature-chess.org/
We are waiting to get the BugzillaReports extension running to move the rest.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.5 release ===

Tasks COMMITTED for Miniature 0.5.

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=High
|status=unconfirmed,new,assigned,needinfo,reopened,resolved,verified
|sort=status,severity,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [http://miniature-chess.org/wiki/Wishlist Wishlist].

Talk:Task:100Days

2011-09-19T22:20:57Z

192.100.106.40: Undo revision 45376 by 199.168.142.166 (Talk)

== Next Steps ==
It looks like the 100 Days brainstorm has reached its conclusion. The pre-agreed ideas will be discussed next Tuesday in the maemo.org June sprint meeting. We might add more tasks coming from the current backlog. The ideas ''still under discussion'' should be probably moved to the 2010 Agenda for further brainstorm.--[[User:qgil|qgil]] 20:09, 8 June 2008 (UTC)

== Scope of the 100 Days ==

== How can I help? ==

How can I help in this process, as one of the people responsible of the maemo.org planning at Nokia? I could help organizing the content, identifying what is out of scope or what more realistically falls in the Agenda 2010. Or I could just shut up and let you work. :) fyi, in the meantime I'm already working on the maemo.org short and mid term plans internally at Nokia. --[[User:qgil|qgil]] 19:05, 1 June 2008 (UTC)
:I don't think a little direction will repress things too much at this point, and I definitely thing it will help stimulate and focus the brainstorm. Not only because of the clearer definition of purpose, scope and direction, but also from the interest a more visible Nokia involvement would make. The end result, of course, being a much more productive session. --[[User:generalantilles|generalantilles]] 20:15, 1 June 2008 (UTC)
::I will start leaving signed comments, not to touch the original text. Then you decide what to do with it.--[[User:qgil|qgil]] 06:20, 2 June 2008 (UTC)

== Russian language section ==
Is it possible to create the Russian-language section of wiki ? We would like to move here wiki.internet-tablet.com materials and translations. --[[User:dik|dik]] 22:30, 30 June 2008 (UTC)
::Interesting, but out of scope in the [[100Days]] work. I recommend you to ask at [[Talk:Maemowiki_Action_Group]].--[[User:qgil|qgil]] 23:01, 30 June 2008 (UTC)

== Clear and useful planning pages ==

The 100 days page is getting longer. I think at the end what we all want to have is a list of clear actions, being most/all of them links to pages where each action is discussed and planned in detail. Proposal to get there:
* Create pages for those topics that already got interest and meat enough. Move there all their related ideas and comments. This includes the content in this discussion lisrt, since having it hidden here or even duplicated is not going to help.
* Put at the top the items that are pre-agreed: no-brainer stuff, items with lots of community support, items already acceopted by Nokia and/or the maemo.org guys.
* New good ideas are added in the bottom and end up either in the top after being pre-agreed, or moved to other existing pages.
--[[User:qgil|qgil]] 08:09, 2 June 2008 (UTC)

= Proposals out of scope =
Archiving here proposals that don't fit in the 100 Days exercise. Please relocate somewhere if the ideas are good.

== Update developer libraries ==
* gcc-4.x, glib, powervr, it's important to give developers much more time to play with newer tools than short before a major upgrade takes place (of course with disclaimer that nothing is guaranteed to be shipped in a certain way)
* Update the vmware appliance with sb2 and python2.5 setted. And more publicity on the vmware appliance, as there is already one on garage, but many don't know it.
:''This is out of scope in this maemo.org exercise. About giving more publicity to https://garage.maemo.org/projects/maemo-sdk/ and http://maemo-sdk.garage.maemo.org/ - it's currently an alpha and the developers don't feel like advertising it much more. But anybody can follow the Garage project and, well, nobody is stopping you from advertise it more. :) --[[User:qgil|qgil]] 07:53, 2 June 2008 (UTC)''
::''Alpha status doesn't mean that it is unusable, I use this VM regularly and it works very well. I really think this one should be promoted on maemo.org. --[[User:xfade|xfade]] 13:55, 2 June 2008 (UTC)''
::: ''Official x86_64 support will be great or at least i386 on top of x86_64. Other distributions too - some of them only need an alien. [[User:bundyo|bundyo]] 20:47, 2 June 2008 (UTC)''

== A few suggestions for developers ==
A few more suggestions for developers - the bottom rungs of the ladder.

1. Validate and verify the tools installation for the current shipping version, particularly the HOWTO. I follow the instructions but nothing builds. At least until I do an apt-get dist-upgrade, update, upgrade or something similar, then apt-get the -dev versions of a half dozen things, none of which is mentioned. Which brings me to:

2. Insure the hello-world will actually build on a system cleanly installed following the exact instructions from step 1. (I had to edit things in mine) and form a deb which will work on a tablet - both install and remove. Also split out stand-alone versions to use as templates (I can't get a statusbar only version to come up as everything seems to be interdependent). Maemopad is a great write template, but a paint template (slightly more than trivial graphic demo) would be nice.

Hildon is not something I've dealt with, and has its own quirks along with GTK. They aren't bad, but I could spend a week just learning the ins and outs. But there aren't very many examples I can just change the icons and add in a chunk of code to do a simple task as a starting point, at least not without doing a lot of searching (e.g. some statusbar clocks are stand-alone).

3. Simplify the autogen/automake/autoconf stuff. Most of this will only be run under fixed releases, so the checking for some specific version of 20 libraries is redundant, and makes the build horribly complicated. Either in scratchbox things are there or not (and see #1 above if they are not! I also have to keep doing apt-gets since I need -dev of everything and often don't have them). Do I really need libtool for a trivial statusbar app?

:Autoconf is actually quite important for code portability, not only across maemo releases (1.0, 1.1, mistral, scirocco, bora, chinook, diablo and so on) but also (and more importantly) across platforms. There is a lot of cross-pollination happening right now, and that's a very good thing IMHO. It will make your life much easier when you decide to port your application to (for example) Ubuntu Mobile, Openmoko or "desktop" GNOME, and it also makes porting stuff from other platforms to maemo simpler.
: Having said that, it is a bit of a learning curve, but perhaps what's needed is more entry-level documentation/tutorials (chapter 5 is a very good start at that) and tools to simplify bootstrapping (like the anjuta plugin).
:: Autoconf is not necessary to write portable software, while making your makefiles unreadable. Therefore, its use has to be made optional.

The goal is that anyone should be able to do a working deb for a trivial off-the-cuff application or status bar, home, or control panel applet in 5 minutes by doing a global substitute (or perhaps changing a few lines of the form: #define APPNAME HILDON_HELLO_WORLD, #define AppName HildonHelloWorld, #define appname hildon_hello_world, etc.) and adding a few lines of code and scaled icons.

And for "garage", there should be one centralized repository, so there would be a "garage" parallel to "extras" with all betas and releases not higher up in the chain. Right now I've got dozens of archives and sources, so when I do a restore it becomes a nightmare getting all the applications back and it makes application manager slower having to go through dozens of archives. It doesn't help having a "garage page" if it is not much better than hosting offsite. But then for all these add-ons I could just do apt-get source and/or apt-get install. Maybe this is what "extras" is for, but it seems to never work or have anything. —Preceding unsigned comment added by [[User:70.209.165.167|70.209.165.167]] 19:32, 29 May 2008 (UTC)

Miniature/Development

2011-09-08T17:31:16Z

192.100.106.40: /* Localization */

{{Miniature}}
[[Image:Miniature_Berlin_Defence.png|310px|thumb|The Berlin Defence, as seen in Miniature]]

== The concept ==
[[Miniature]] is a chess board that is always with you, ready to let you play and learn wherever you go.

* The main use case is playing online against other players at http://www.freechess.org/ (FICS)
* Now imagine that you can also chat with the other player.
* Play P2P games against other players next to you or remotely with your Contacts.
* Learning is important: watch games live, review stored games and also process offline the lessons offered at FICS.
* And not only regular chess. Think also on Suicide, Crazyhouse...

Miniature is a Qt application with a C/C++ backend and a QML UI. The architecture is modular, thinking on the addition of different servers and types of interaction.

We are targeting our development on MeeGo Harmattan and the Nokia N9 but we welcome maintainers for other ports e.g. MeeGo upstream, Symbian, Android-Necessitas, Qt powered desktops...

== Project news ==
* 2011-08-29: [https://bugs.maemo.org/show_bug.cgi?id=12355 first patch] from Uwe Kaminski aka jukey committed to the Miniature project. Thank you!
* 2011-08-28: "New seek" feature implemented, mikhas and jukey play the first Miniature vs Miniature game from their devices.
* 2011-08-26: First real & unstable [https://bugs.maemo.org/show_bug.cgi?id=12342#c2 FICS games played]. First it was mikhas against himhelf, then mikhas-qgil. :)
* 2011-08-25: [http://flors.wordpress.com/2011/08/25/how-quick-i-got-started-with-qt-quick/ How quick I got started with Qt Quick] - blog post from Quim Gil featuring Miniature.
* 2011-08-25: Miniature 0.3 [https://garage.maemo.org/pipermail/chess-developer/2011-August/000185.html runs in MeeGo 1.2 CE] on a Nokia N900 (with some bugs).
* '''2011-08-23: [http://wiki.maemo.org/Miniature/0.3_Berlin_Defence Miniature 0.3 ''Berlin Defence''] released.'''
* 2011-08-15: New Miniature UX concepts integrated to the master branch - the new engine gets a UI ([http://wiki.maemo.org/images/2/25/2011-08-12_16-25-47.png screenshot]).
* 2011-08-13: Miniature can be developed using Qt Creator ([https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk instructions]).
* 2011-08-01: [https://garage.maemo.org/pipermail/chess-developer/2011-August/000159.html Miniature 0.2.1 released!] The new Encore engine and the new QML UI, together for the first time. The game can do real seeks but still no real games.
* 2011-07-27: New UI targetting MeeGo Harmattan developed in parallel - [https://gitorious.org/testdef source] & [https://bugs.maemo.org/show_bug.cgi?id=12315 packages] for Nokia N9/N950.
* 2011-07-18: engine refactored around [https://garage.maemo.org/pipermail/chess-developer/2011-July/000153.html Encore], a GNUChess wrapper. This is the beginning of a rewrite.
* 2011-07-06: request to port to [[Meego]] : http://forum.meego.com/showthread.php?p=25031

The Miniature project was born as a proposal sent to the Maemo community on 2009-10-31. Check the [[Miniature/archive|archive]] if you want to dig in the past.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.4 release ===

See [[Miniature/0.4_De_Lucena]]

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=High
|status=unconfirmed,new,assigned,needinfo,reopened,resolved,verified
|sort=status,severity,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,severity,priority,assignee,status,resolution,summary
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [[Miniature/Wishlist|Wishlist]].

== Get involved ==
Contributions are welcome! This is how you can get started:

* [[Miniature#Download|Download]] or [[#SDK instructions|build]] Miniature, and [[Miniature#Contact us|tell us]] what you think
* Spread the Miniature love among your Chess friendly contacts
* Test the game and [https://bugs.maemo.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Miniature&content= check/file bugs]
**Follow all of the project's bug by entering <code>general@miniature.garage.bugs</code> into the ''Add users to my watch list (comma separated list)'' input field
* Fix an open bug in the [[Miniature/Development#Backlog|Backlog]], for instance an [https://bugs.maemo.org/buglist.cgi?keywords=easyfix&query_format=advanced&keywords_type=allwords&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Miniature&classification=Extras easyfix].
* Help planning and implementing [[Miniature/Wishlist|new features]]
* Help porting Miniature to more platforms

=== Localization ===
The localization work hasn't started yet and as a matter of fact our strings are still not L10n ready. It's in our ToDo list, do you want to help?

=== SDK instructions ===
Currently you can build Miniature with the latest Qt SDK (including the Harmattan target) or the Harmattan Platform SDK. The Miniature sources and commit logs are available at https://gitorious.org/miniature/ . Both SDKs come with an emulator for deploying your app. All the better if you have a Nokia N950 or N9 to test on device.

Instructions to set you Miniature development environment:
* [https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk Qt SDK]
* Harmattan Platform SDK instructions are currently missing. fwiw the [[Miniature/Development/Instructions|Maemo Platform SDK]] might help since both are based on Scratchbox...
=== Set up a personal clone repository of Minature ===
If you plan to get involved deeper into development it's a good idea to create a personal clone of the Minature git source repository. This allows you to do merge requests for patches you created in your clone repository. The cloned repository should be connected to Minature as upstream to make it easy to fetch changes from there. Step-by-step description:
*Create an gitorious account or log in and make sure to have an SSH-Key in place
*[https://gitorious.org/miniature/miniature/clone Clone repository]
*To allow pushing to your clone repository Follow the instructions you will get if you click onto the little green question mark next to the clone URL.
*enable upstream: Open a terminal and switch into the local folder of your clone project and enter:
git remote add upstream git://gitorious.org/miniature/miniature.git
*fetch upstream data:
git fetch upstream master
*Create merge requests: You can use the "Request merge" button in your gitorious clone project website.

=== Send us patches! ===
Found a bug? Spotted code smell? We glady accept patches! There are three ways to send patches to us:
* By [https://bugs.maemo.org/buglist.cgi?product=Miniature reporting the bug], and hopefully attaching a patch that solves the stated problem (but just reporting bugs is also appreciated).
* By using the [https://garage.maemo.org/mailman/listinfo/chess-developer chess-devel mailing list]: A ML-friendly patch can be created with "git format-patch HEAD~n", where n specifices how many commits (starting from HEAD) should be converted to patches;
* By issuing a merge request: Send us a link to your public git repo (including branch/revision), or use the merge request feature from http://gitorious.org.

=== Architecture ===
See the [[Miniature/Development/Architecture|Miniature architecture]] wiki page. (outdated)

== Contributors ==
Maintainers:
* [http://maemo.org/profile/view/mikhas Michael Hasselmann]: lead developer
* [http://maemo.org/profile/view/qgil Quim Gil]: UX & documentation

Gave a big hand:
* [http://maemo.org/profile/view/kore Dennis Stötzel]: chess logics
* [http://maemo.org/profile/view/hasselmm Mathias Hasselmann]: veteran programmer
* [http://gitorious.org/~Malcolm Dariusz Mikulski]: P2P telepathy integration

Special thanks:
* [http://maemo.org/profile/view/kittykat kittykat]: game icon
* [http://en.wikipedia.org/wiki/User:Cburnett Colin M.L. Burnett]: free piece set used by Wikipedia

Miniature

2011-08-31T23:46:42Z

192.100.106.40:

{{Miniature}}
[[Category:Games]]
[[Image:2011-08-22_15-51-28.png|310px|thumb|An opening in Miniature]]
You love chess. You love mobile devices. You believe they fit so well... yet you haven't found a convincing implementation of a free chess game. '''Miniature''' to the rescue!

Miniature is a chess board that is always with you, ready to let you play and learn wherever you go

At the moment we target MeeGo Harmattan running on the Nokia N9 and N950.

Feedback, features and ports to other platforms & devices are welcome!

[https://twitter.com/#!/miniaturechess Follow us also on Twitter]

== Download ==

Miniature is not ready for end users BUT we have releases for early adopters willing to contribute feedback, fixes or new features.

=== MeeGo Harmattan ===
[[Miniature/0.3 Berlin Defence|'''Miniature 0.3 ''Berlin Defence''''']] for MeeGo Harmattan - runs on Nokia N950, N9 and SDK emulators

=== Maemo ===
The first version of Miniature to play games offline & P2P on the '''Nokia N900''' can be found in the [[Extras-devel]] repository. Not maintained anymore.

== Features ==

Look also the [[/Wishlist]] to see what is coming (if someone does the homework). ;)

=== Play online - FICS (under development) ===
* Login to [http://freechess.org FICS] as registered user or guest.
* See offers to play a game.
* Filter offers by type of game, time, increment and type of rating (under development).
* Create a new offer to play a game (under development).
* Play a game against another FICS user (under development).
* Chat with the opponent while playing (under development).
* [http://www.freechess.org/Help/HelpFiles/timeseal.html Timeseal] support (under development).

== Screenshots ==
These are real screenshots taken from Miniature running on a Nokia N9. Click the images for more details.

<gallery widths=200px>
Image:Miniature-FICS.png |<div style="padding:0em .5em;">Login to FICS</div>
Image:2011-08-22_13-53-16.png |<div style="padding:0em .5em;">List of games available</div>
Image:2011-08-22_13-53-40.png |<div style="padding:0em .5em;">A game is selected</div>
Image:2011-08-22_13-54-11.png |<div style="padding:0em .5em;">Filtering search by type of chess</div>
Image:2011-08-22_13-54-33.png |<div style="padding:0em .5em;">Filtering search by time</div>
Image:2011-08-22 13-55-19.png |<div style="padding:0em .5em;">Filtering search by type of rating</div>
Image:2011-08-22 13-57-04.png |<div style="padding:0em .5em;">Initial position</div>
Image:2011-08-22 13-57-29.png |<div style="padding:0em .5em;">Selecting a piece</div>
Image:2011-08-22 13-58-07.png |<div style="padding:0em .5em;">Aiming to a destination square</div>
Image:2011-08-22_13-58-31.png |<div style="padding:0em .5em;">Move completed</div>
Image:2011-08-22 15-51-28.png |<div style="padding:0em .5em;">Playing... (still not for real)</div>
Image:2011-08-22 13-59-01.png |<div style="padding:0em .5em;">Chat area expanded</div>
Image:2011-08-22 14-00-29.png |<div style="padding:0em .5em;">Typing in chat area</div>
Image:2011-08-22 14-01-20.png |<div style="padding:0em .5em;">Leaving a game</div>
Image:2011-08-22 14-01-55.png |<div style="padding:0em .5em;">Example of confirmation dialog</div>
Image:Miniature_Berlin_Defence.png |<div style="padding:0em .5em;">The Berlin Defence, as seen in Miniature</div>
</div>
</gallery>

== Contact us ==
We love feedback!

* Via IRC at #miniature in irc.freenode.net
* Via [http://forum.meego.com/showthread.php?t=4301 web forum]
* Via email at the [https://garage.maemo.org/pipermail/chess-developer/ project's mailing list]
* Bug reports and enhancement requests can be filed [http://bit.ly/n44i1G here] ([https://bugs.maemo.org/enter_bug.cgi?product=Miniature file new bug])

== Get involved ==

See the [[/Development]] section to know more about the project status and areas welcoming help.

We welcome testers and contributors!

Miniature is a Qt application with a C/C++ backend and a QML UI. The architecture is modular, thinking on the addition of different servers and types of interaction. If you are thinking on bringing new features let us convince you. :)

We are targeting our development on MeeGo Harmattan and the Nokia N9 but we welcome maintainers for other ports e.g. MeeGo upstream, Symbian, Android-Necessitas, Qt powered desktops...

== History ==

Yes, we do have some history at this point. It all started here:

* 2009-10-31: First idea proposed in a Talk thread: [http://talk.maemo.org/showthread.php?t=33764 Contributors needed: the killer free chess game for Maemo]

Check the [[/archive|archive]] if you want to know more.

Miniature/Development

2011-08-31T20:44:23Z

192.100.106.40: /* Miniature 0.4 release */

{{Miniature}}
[[Image:Miniature_Berlin_Defence.png|310px|thumb|The Berlin Defence, as seen in Miniature]]

== The concept ==
[[Miniature]] is a chess board that is always with you, ready to let you play and learn wherever you go.

* The main use case is playing online against other players at http://www.freechess.org/ (FICS)
* Now imagine that you can also chat with the other player.
* Play P2P games against other players next to you or remotely with your Contacts.
* Learning is important: watch games live, review stored games and also process offline the lessons offered at FICS.
* And not only regular chess. Think also on Suicide, Crazyhouse...

Miniature is a Qt application with a C/C++ backend and a QML UI. The architecture is modular, thinking on the addition of different servers and types of interaction.

We are targeting our development on MeeGo Harmattan and the Nokia N9 but we welcome maintainers for other ports e.g. MeeGo upstream, Symbian, Android-Necessitas, Qt powered desktops...

== Project news ==
* 2011-08-29: [https://bugs.maemo.org/show_bug.cgi?id=12355 first patch] from Uwe Kaminski aka jukey committed to the Miniature project. Thank you!
* 2011-08-28: "New seek" feature implemented, mikhas and jukey play the first Miniature vs Miniature game from their devices.
* 2011-08-26: First real & unstable [https://bugs.maemo.org/show_bug.cgi?id=12342#c2 FICS games played]. First it was mikhas against himhelf, then mikhas-qgil. :)
* 2011-08-25: [http://flors.wordpress.com/2011/08/25/how-quick-i-got-started-with-qt-quick/ How quick I got started with Qt Quick] - blog post from Quim Gil featuring Miniature.
* 2011-08-25: Miniature 0.3 [https://garage.maemo.org/pipermail/chess-developer/2011-August/000185.html runs in MeeGo 1.2 CE] on a Nokia N900 (with some bugs).
* '''2011-08-23: [http://wiki.maemo.org/Miniature/0.3_Berlin_Defence Miniature 0.3 ''Berlin Defence''] released.'''
* 2011-08-15: New Miniature UX concepts integrated to the master branch - the new engine gets a UI ([http://wiki.maemo.org/images/2/25/2011-08-12_16-25-47.png screenshot]).
* 2011-08-13: Miniature can be developed using Qt Creator ([https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk instructions]).
* 2011-08-01: [https://garage.maemo.org/pipermail/chess-developer/2011-August/000159.html Miniature 0.2.1 released!] The new Encore engine and the new QML UI, together for the first time. The game can do real seeks but still no real games.
* 2011-07-27: New UI targetting MeeGo Harmattan developed in parallel - [https://gitorious.org/testdef source] & [https://bugs.maemo.org/show_bug.cgi?id=12315 packages] for Nokia N9/N950.
* 2011-07-18: engine refactored around [https://garage.maemo.org/pipermail/chess-developer/2011-July/000153.html Encore], a GNUChess wrapper. This is the beginning of a rewrite.
* 2011-07-06: request to port to [[Meego]] : http://forum.meego.com/showthread.php?p=25031

The Miniature project was born as a proposal sent to the Maemo community on 2009-10-31. Check the [[Miniature/archive|archive]] if you want to dig in the past.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.4 release ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|priority=High
|status=unconfirmed,new,assigned,needinfo,reopened,resolved,verified
|sort=priority,severity,priority,status,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [[Miniature/Wishlist|Wishlist]].

== Get involved ==
Contributions are welcome! This is how you can get started:

* [[Miniature#Download|Download]] or [[#SDK instructions|build]] Miniature, and [[Miniature#Contact us|tell us]] what you think
* Spread the Miniature love among your Chess friendly contacts
* Test the game and [https://bugs.maemo.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Miniature&content= check/file bugs]
* Fix an open bug in the [[Miniature/Development#Backlog|Backlog]], for instance an [https://bugs.maemo.org/buglist.cgi?keywords=easyfix&query_format=advanced&keywords_type=allwords&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Miniature&classification=Extras easyfix].
* Help planning and implementing [[Miniature/Wishlist|new features]]
* Help porting Miniature to more platforms

=== Localization ===
The localization work hasn't started yet and as a matter of fact our string are still not L10n ready. It's in our ToDo list, do you want to help?

=== SDK instructions ===
Currently you can build Miniature with the latest Qt SDK (including the Harmattan target) or the Harmattan Platform SDK. The Miniature sources and commit logs are available at https://gitorious.org/miniature/ . Both SDKs come with an emulator for deploying your app. All the better if you have a Nokia N950 or N9 to test on device.

Instructions to set you Miniature development environment:
* [https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk Qt SDK]
* Harmattan Platform SDK instructions are currently missing. fwiw the [[Miniature/Development/Instructions|Maemo Platform SDK]] might help since both are based on Scratchbox...
=== Set up a personal clone repository of Minature ===
If you plan to get involved deeper into development it's a good idea to create a personal clone of the Minature git source repository. This allows you to do merge requests for patches you created in your clone repository. The cloned repository should be connected to Minature as upstream to make it easy to fetch changes from there. Step-by-step description:
*Create an gitorious account or log in and make sure to have an SSH-Key in place
*[https://gitorious.org/miniature/miniature/clone Clone repository]
*enable upstream: Open a terminal and switch into the local folder of your clone project and enter:
git remote add upstream git://gitorious.org/miniature/miniature.git
*fetch upstream data:
git fetch upstream
*Create merge requests: You can use the "Request merge" button in your gitorious clone project website.

=== Send us patches! ===
Found a bug? Spotted code smell? We glady accept patches! There are three ways to send patches to us:
* By [https://bugs.maemo.org/buglist.cgi?product=Miniature reporting the bug], and hopefully attaching a patch that solves the stated problem (but just reporting bugs is also appreciated).
* By using the [https://garage.maemo.org/mailman/listinfo/chess-developer chess-devel mailing list]: A ML-friendly patch can be created with "git format-patch HEAD~n", where n specifices how many commits (starting from HEAD) should be converted to patches;
* By issuing a merge request: Send us a link to your public git repo (including branch/revision), or use the merge request feature from http://gitorious.org.

=== Architecture ===
See the [[Miniature/Development/Architecture|Miniature architecture]] wiki page. (outdated)

== Contributors ==
Maintainers:
* [http://maemo.org/profile/view/mikhas Michael Hasselmann]: lead developer
* [http://maemo.org/profile/view/qgil Quim Gil]: UX & documentation

Gave a big hand:
* [http://maemo.org/profile/view/kore Dennis Stötzel]: chess logics
* [http://maemo.org/profile/view/hasselmm Mathias Hasselmann]: veteran programmer
* [http://gitorious.org/~Malcolm Dariusz Mikulski]: P2P telepathy integration

Special thanks:
* [http://maemo.org/profile/view/kittykat kittykat]: game icon
* [http://en.wikipedia.org/wiki/User:Cburnett Colin M.L. Burnett]: free piece set used by Wikipedia

Miniature/Development

2011-08-31T20:43:54Z

192.100.106.40: /* Miniature 0.4 release */

{{Miniature}}
[[Image:Miniature_Berlin_Defence.png|310px|thumb|The Berlin Defence, as seen in Miniature]]

== The concept ==
[[Miniature]] is a chess board that is always with you, ready to let you play and learn wherever you go.

* The main use case is playing online against other players at http://www.freechess.org/ (FICS)
* Now imagine that you can also chat with the other player.
* Play P2P games against other players next to you or remotely with your Contacts.
* Learning is important: watch games live, review stored games and also process offline the lessons offered at FICS.
* And not only regular chess. Think also on Suicide, Crazyhouse...

Miniature is a Qt application with a C/C++ backend and a QML UI. The architecture is modular, thinking on the addition of different servers and types of interaction.

We are targeting our development on MeeGo Harmattan and the Nokia N9 but we welcome maintainers for other ports e.g. MeeGo upstream, Symbian, Android-Necessitas, Qt powered desktops...

== Project news ==
* 2011-08-29: [https://bugs.maemo.org/show_bug.cgi?id=12355 first patch] from Uwe Kaminski aka jukey committed to the Miniature project. Thank you!
* 2011-08-28: "New seek" feature implemented, mikhas and jukey play the first Miniature vs Miniature game from their devices.
* 2011-08-26: First real & unstable [https://bugs.maemo.org/show_bug.cgi?id=12342#c2 FICS games played]. First it was mikhas against himhelf, then mikhas-qgil. :)
* 2011-08-25: [http://flors.wordpress.com/2011/08/25/how-quick-i-got-started-with-qt-quick/ How quick I got started with Qt Quick] - blog post from Quim Gil featuring Miniature.
* 2011-08-25: Miniature 0.3 [https://garage.maemo.org/pipermail/chess-developer/2011-August/000185.html runs in MeeGo 1.2 CE] on a Nokia N900 (with some bugs).
* '''2011-08-23: [http://wiki.maemo.org/Miniature/0.3_Berlin_Defence Miniature 0.3 ''Berlin Defence''] released.'''
* 2011-08-15: New Miniature UX concepts integrated to the master branch - the new engine gets a UI ([http://wiki.maemo.org/images/2/25/2011-08-12_16-25-47.png screenshot]).
* 2011-08-13: Miniature can be developed using Qt Creator ([https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk instructions]).
* 2011-08-01: [https://garage.maemo.org/pipermail/chess-developer/2011-August/000159.html Miniature 0.2.1 released!] The new Encore engine and the new QML UI, together for the first time. The game can do real seeks but still no real games.
* 2011-07-27: New UI targetting MeeGo Harmattan developed in parallel - [https://gitorious.org/testdef source] & [https://bugs.maemo.org/show_bug.cgi?id=12315 packages] for Nokia N9/N950.
* 2011-07-18: engine refactored around [https://garage.maemo.org/pipermail/chess-developer/2011-July/000153.html Encore], a GNUChess wrapper. This is the beginning of a rewrite.
* 2011-07-06: request to port to [[Meego]] : http://forum.meego.com/showthread.php?p=25031

The Miniature project was born as a proposal sent to the Maemo community on 2009-10-31. Check the [[Miniature/archive|archive]] if you want to dig in the past.

== Project status ==

Tasks for the next release get a HIGH priority. All the rest falls in the Backlog.

=== Miniature 0.4 release ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|priority=High
|target_milestone=0.4
|status=unconfirmed,new,assigned,needinfo,reopened,resolved,verified
|sort=priority,severity,priority,status,id
}}

=== Backlog ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|priority=Medium,Low,Unspecified
|status=unconfirmed,new,assigned,needinfo,reopened
|sort=status,id
}}

=== Easyfix (suited for newcomers) ===

{{#bugzilla:
|columns=id,summary,severity,priority,status
|product=Miniature
|keywords=easyfix
|status=unconfirmed,new,assigned,reopened
|sort=priority,severity,priority,status,id
}}

Looking for more? There is more at the [[Miniature/Wishlist|Wishlist]].

== Get involved ==
Contributions are welcome! This is how you can get started:

* [[Miniature#Download|Download]] or [[#SDK instructions|build]] Miniature, and [[Miniature#Contact us|tell us]] what you think
* Spread the Miniature love among your Chess friendly contacts
* Test the game and [https://bugs.maemo.org/buglist.cgi?query_format=specific&order=relevance+desc&bug_status=__open__&product=Miniature&content= check/file bugs]
* Fix an open bug in the [[Miniature/Development#Backlog|Backlog]], for instance an [https://bugs.maemo.org/buglist.cgi?keywords=easyfix&query_format=advanced&keywords_type=allwords&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&product=Miniature&classification=Extras easyfix].
* Help planning and implementing [[Miniature/Wishlist|new features]]
* Help porting Miniature to more platforms

=== Localization ===
The localization work hasn't started yet and as a matter of fact our string are still not L10n ready. It's in our ToDo list, do you want to help?

=== SDK instructions ===
Currently you can build Miniature with the latest Qt SDK (including the Harmattan target) or the Harmattan Platform SDK. The Miniature sources and commit logs are available at https://gitorious.org/miniature/ . Both SDKs come with an emulator for deploying your app. All the better if you have a Nokia N950 or N9 to test on device.

Instructions to set you Miniature development environment:
* [https://gitorious.org/miniature/miniature/blobs/raw/master/README.qt-sdk Qt SDK]
* Harmattan Platform SDK instructions are currently missing. fwiw the [[Miniature/Development/Instructions|Maemo Platform SDK]] might help since both are based on Scratchbox...
=== Set up a personal clone repository of Minature ===
If you plan to get involved deeper into development it's a good idea to create a personal clone of the Minature git source repository. This allows you to do merge requests for patches you created in your clone repository. The cloned repository should be connected to Minature as upstream to make it easy to fetch changes from there. Step-by-step description:
*Create an gitorious account or log in and make sure to have an SSH-Key in place
*[https://gitorious.org/miniature/miniature/clone Clone repository]
*enable upstream: Open a terminal and switch into the local folder of your clone project and enter:
git remote add upstream git://gitorious.org/miniature/miniature.git
*fetch upstream data:
git fetch upstream
*Create merge requests: You can use the "Request merge" button in your gitorious clone project website.

=== Send us patches! ===
Found a bug? Spotted code smell? We glady accept patches! There are three ways to send patches to us:
* By [https://bugs.maemo.org/buglist.cgi?product=Miniature reporting the bug], and hopefully attaching a patch that solves the stated problem (but just reporting bugs is also appreciated).
* By using the [https://garage.maemo.org/mailman/listinfo/chess-developer chess-devel mailing list]: A ML-friendly patch can be created with "git format-patch HEAD~n", where n specifices how many commits (starting from HEAD) should be converted to patches;
* By issuing a merge request: Send us a link to your public git repo (including branch/revision), or use the merge request feature from http://gitorious.org.

=== Architecture ===
See the [[Miniature/Development/Architecture|Miniature architecture]] wiki page. (outdated)

== Contributors ==
Maintainers:
* [http://maemo.org/profile/view/mikhas Michael Hasselmann]: lead developer
* [http://maemo.org/profile/view/qgil Quim Gil]: UX & documentation

Gave a big hand:
* [http://maemo.org/profile/view/kore Dennis Stötzel]: chess logics
* [http://maemo.org/profile/view/hasselmm Mathias Hasselmann]: veteran programmer
* [http://gitorious.org/~Malcolm Dariusz Mikulski]: P2P telepathy integration

Special thanks:
* [http://maemo.org/profile/view/kittykat kittykat]: game icon
* [http://en.wikipedia.org/wiki/User:Cburnett Colin M.L. Burnett]: free piece set used by Wikipedia