doubean

An unofficial Douban app for browsing Groups and exploring Subjects (books/movies/TVs) (豆瓣非官方app，支持小组浏览和书影探索)

Disclaimer: This is a continuously evolving project focused on core features using Jetpack Compose. Some features are a work-in-progress (WIP), and you may encounter bugs.

Known Issues

• Crash on Topic Screen: May crash on some devices when scrolling. See issue #19 for details.

Features

• Subjects (Books/Movies/TVs):

  • Home feed with personal statuses, subject unions, and rank lists
  • View subject interests
  • Search for subjects
  • View subject details, including metadata, intros, and user interactions
  • Browse rank lists

• Groups:

  • Browse my groups and topics
  • Explore group details, topics, and comments
  • Search for groups
  • Enhancements:
    • Pin group tabs locally for quick access
    • Sort topics within each page by create time or default order
    • Customizable topic notifications

• Doulists:

  • View doulists and their items (topics, subjects, reviews)
  • Collect subjects and topics into doulists
  • My Doulists: Collected items + doulists

• General:

  • Ad-free and lightweight (~3MB)
  • Login support & session reuse (advanced, root required)
  • Partial deep linking
  • Direct official API calls
  • Basic Material Design 3 (MD3) theming
  • Basic image viewer
  • User profile screen
  • View statuses feed (legacy)
  • Mobile-optimized pure Web screens (legacy)

Screenshots

Getting Started

• Download the Latest release
• Install on Android: 8.1+
• Feel free to file issues
• Keep official app: Recommended for full platform functionality
• Troubleshooting: If crashes occur after updates, try clearing app data

Important Notices

Source Code Status

Only selected source code from a private project is shared here to avoid potential issues. More may be synced later.

Guidelines

• For personal learning & exploration
• Please avoid wide promotion

Tech Stack

• Foundation: Android KTX
• Architecture: Lifecycles, Navigation, Paging, Room, DataStore, ViewModel, WorkManager
• UI: Jetpack Compose
• Behavior: Notifications
• Third-party libraries
  • Kotlin Coroutines, Kotlinx Serialization, Ktor, Coil, libsu, Accompanist Permissions/WebView

Roadmap

Upcoming features, bug fixes, libraries to use and environment changes (roughly in chronological order). Primarily for personal tracking.

Current release (0.9.14)

Next release (0.10.0)

Future plans (Click to expand)

High Priority

Backlog

• Navigation
  • Navigation 3 when deeplink is supported (nav3-recipes #97)
  • Consider use single NavHost (?)
  • Allow customizing bottom navigation (#16)
  • Shared element transitions for images
• Add error message mappings to match official
• Groups
  • Interactions
    • Pin my groups
    • Official-style list item actions
  • Simplify topic caching
  • Search:
    • Topics within a group/tab
    • Global topic search
    • Tabbed search results
  • New web-based feed for all followed topics
    • Toggleable "My Group Topics" section on the home screen
    • Sort by creation time or "Hotness" (replies + 1 / time)
    • Notification engine with customizable intervals (15m, 30m, 1h)
    • Per-group settings for sort preference and check depth (with a UI hint suggesting small values for active groups)
  • Home: Potential pagination for recommended topics
  • Tab
    • Track topic read status
    • Dynamic topic sorting options
  • Group Detail: Auto-collapse header for subscribed/pinned groups/tabs
  • Topic:
    • Render content using the same HTML/WebView approach as topics
    • Fix content scroll restoration
  • Default hide officially-flagged "unfriendly" content
  • Implement content blocking
  • Reddit-style list item expand/collapse
• Subjects
  • Subject Detail
    • Ratings histogram
    • Trailer playback (comment in #15)
    • Toggle default or hot interests
  • Review: Load with HTML like topic content
  • Color schemes
  • More
• UserProfile: My subjects, My groups
• i18n
  • Language selection
  • AI translation support
• Doulists
  • Edit/remove posts
  • Follow Doulists
  • List/post pagination
• Search suggestions
• Login: Code-based (w/o pw)
• Shortcuts
• NetworkManager
• Widgets: Calender today
• QR
• (Rooted users) Optional sync of more existing preferences for API request consistency
• Statuses (maintenance mode)
  • Additional card types
  • Pagination

Ongoing Improvements

• Ensure basic dark mode, landscape & tablet support
• Sync more source to public repo
• Full deep linking support
• Improve model layering
• i18n: Translations
• Test

References

• Official and unofficial sample apps
• Developer Guides
• Material Design
• Various social apps (UI/UX inspiration)

Utilities

• HTTPCanary for analyzing API
• jadx-gui for model understanding
• Google Chrome for debugging CSS

Stars ⭐ & Donation ☕

Your ⭐ stars motivate continued development! If you find this project helpful and wish to support its development, you can treat me to a coffee via WeChat Pay:

Thank you for your support!

License

This project is licensed under the MIT License. See the LICENSE file for the full license text.