The one problem that I get constantly on our forums was the incompatibility of BP Gallery template files with custom themes. Since BuddyPress 1.7 paved the way for using any WordPress theme as BuddyPress compatible, It was really getting difficult for us to keep template packs for each and every theme out there.
I have been planning to add theme compatibility, but I never wanted to add so many hacks. Finally, A little bit research into the code and I managed to do it in 20-30 lines( I believe in simplicity ).
If you are installing BP Gallery version 1.3.1, in that case you will notice that the gallery pages are automatically compatible with every theme out there.
It was a long due update, and I am really happy to include it finally.
If you still want full control of the page layout(whole page layout) of gallery pages, you can move "gallery" directory to your theme and modify it. If you just want to control the way gallery items are laid out inside your theme layout(gallery list, media list and other screens items), you can copy the "gallery-theme-compat" directory to your theme and modify the contents as you want.
If you are upgrading from older version, please make sure to take a backup of your "gallery" templates. If the old gallry templates are present inside your theme, those will be used.
A word about future version:-
I don't want to promise anything right now, as in last 2 years I have at least created 3 variations of galley plugin but was never satisfied to release it to public. I have been silently working on it for months and I am really happy with the upcoming major version (1.5). It has all the functionality that has ever come to my notice in last 3 years. The best part is the code base is smaller than the current version. I am using mostly the built in functionality of WordPress. Just to let you know, It will be most advanced Galley plugin available for WordPress/BuddyPress till date(and I have seen hundreds of them) and most usable too. I am almost certain to release a beta by 31st October. Let us hope for the best. if you are curious, I have posted a screenshot on forum about the new activity stream upload method( the current is just not usable enough ).
That's all for now. Go ahead and download the Gallery and give it a try.
Please do let me know if I have missed something in the theme compatibility layer.