Description
MiStoryView is a simple configurable library to integrate stories features into your social media android application.
MiStoryView alternatives and similar packages
Based on the "Kotlin" category.
Alternatively, view MIStoryView alternatives based on common mentions on social networks and blogs.
-
android-youtube-player
YouTube Player library for Android and Chromecast, stable and customizable. -
CalendarView
A highly customizable calendar view and compose library for Android. -
Balloon
:balloon: Modernized and sophisticated tooltips, fully customizable with an arrow and animations for Android. -
Kotterknife
Android view injection writen in Kotlin based on ButterKnife -
kotlin-android-template
Android + Kotlin + Github Actions + ktlint + Detekt + Gradle Kotlin DSL + buildSrc = โค๏ธ -
Shortbread
Android library that creates app shortcuts from annotations -
NotyKT ๐๏ธ
๐ NotyKT is a complete ๐Kotlin-stack (Backend + Android) ๐ฑ application built to demonstrate the use of Modern development tools with best practices implementation๐ฆธ. -
Material Chip View
Material Chip view. Can be used as tags for categories, contacts or creating text clouds -
DrawableToolbox
๐ ๏ธ The missing drawable toolbox for Android. Create drawables programmatically and get rid of the boring and always repeated drawable.xml files. -
Navigation Toolbar for Android
:octocat: Navigation toolbar is a slide-modeled UI navigation controller made by @Ramotion -
CodeView
Display code with syntax highlighting :sparkles: in native way. -
Appyx
Model-driven navigation + UI components with gesture control for Compose Multiplatform -
Capturable
๐Jetpack Compose utility library for capturing Composable content and transforming it into Bitmap Image๐ผ๏ธ -
Pluto Debug Framework
Android Pluto is a on-device debugging framework for Android applications, which helps intercept Network calls, capture Crashes & ANRs, manipulate application data on-the-go, and much more. -
Carousel Recyclerview
Carousel Recyclerview let's you create carousel layout with the power of recyclerview by creating custom layout manager. -
CrunchyCalendar โ awesome calendar widget for android apps
A beautiful material calendar with endless scroll, range selection and a lot more! -
Pdf Viewer For Android
A Lightweight PDF Viewer Android library which only occupies around 125kb while most of the Pdf viewer occupies up to 16MB space. -
Android Kotlin Samples
Some basic samples of Kotlin for Android -
MaterialTimelineView
With MaterialTimelineView you can easily create a material looking timeline. -
SSComposeCookBook
A Collection of major Jetpack compose UI components which are commonly used.๐๐๐ -
MaterialDrawerKt
A Kotlin DSL wrapper around the mikepenz/MaterialDrawer library. -
sliding-panel
Android sliding panel that is part of the view hierarchy, not above it. -
Transition X
{ } Declarative Kotlin DSL for choreographing Android transitions -
Only
:bouquet: An easy way to persist and run code block only as many times as necessary on Android. -
SSCustomBottomNavigation
Animated TabBar with native control and Jetpack Navigation support..โจ๐๐ -
Permission Flow for Android
Know about real-time state of a Android app Permissions with Kotlin Flow APIs. -
Swagger Gradle Codegen
๐ซ A Gradle Plugin to generate your networking code from Swagger -
EasyPermissions-ktx
๐ Kotlin version of the popular google/easypermissions wrapper library to simplify basic system permissions logic on Android M or higher. -
Nextflix-Composable
Includes jetpack compose, navigation, paging, hilt, retrofit, coil, coroutines, flow.. -
Awesome Jetpack compose
A collaborative list of awesome jetpack compose resources. -
DeviceInfo-Sample
[Android Library] Get easy access to device information super fast, real quick -
Intro Showcase View
Highlight different features of the app using Jetpack Compose -
Aimybox voice assistant
Embeddable custom voice assistant for Android applications -
CameraViewEx
Easy Android camera integration, advanced features. -
ZoomHelper
ZoomHelper will make any view to be zoomable just like Instagram pinch-to-zoom -
Events Calendar
Events Calendar is a user-friendly library that helps you achieve a cool Calendar UI with events mapping. You can customise every pixel of the calendar as per your wish and still achieve in implementing all the functionalities of the native android calendar in addition with adding dots to the calendar which represents the presence of an event on the respective dates. It can be done easily, you are just a few steps away from implementing your own badass looking Calendar for your very own project! -
Mutekt
Simplify mutating "immutable" state models (a Kotlin multiplatform library) -
Compose Compiler Reports to HTML Generator
A utility (Gradle Plugin + CLI) to convert Jetpack Compose compiler metrics and reports to beautified HTML page. -
SSCustomEditTextOutLineBorder
Same as the Outlined text fields presented on the Material Design page but with some dynamic changes. ๐ ๐ -
Maildroid
Maildroid is a small robust android library for sending emails using SMTP server -
Turtle ๐ข
Run shell commands from Kotlin scripts, apps or Gradle tasks with ease. -
TimelineView
A customizable and easy-to-use Timeline View library for Android. Works as a RecyclerView decorator (ItemDecoration) -
Vanilla Place Picker
Simple(vanilla) yet 'Do it all' place picker for your place picking needs in Android -
Crowdin Android SDK
Crowdin Android SDK delivers all new translations from Crowdin project to the application immediately
Appwrite - The open-source backend cloud platform
Do you think we are missing an alternative of MiStoryView or a related project?
README
MiStoryView 
MiStoryView is a simple configurable library to integrate stories features into your social media android application.
Preview
Key features
- Set a list of image URLs in MiStoryView.
- Customize duration for the particular story (in milliseconds).
- Set any of the predefined animations, while swiping between multiple stories.
- Move to the back and forth story by tapping on the right and left parts of an image.
- Hold story by just simply touch on it.
- Move to the whole next story or exit full story view, if a user is at the last item of the story.
- Move to the whole previous story or exit the full story view, if a user is at the first item of the story.
- Story indicator color changes once it is seen.
Usage
Dependencies
- Step 1: Add the JitPack repository in your project build.gradle file
bash allprojects { repositories { ... maven { url 'https://jitpack.io' } } }
or
If Android studio version is Arctic Fox or upper then add it in your settings.gradle:
dependencyResolutionManagement {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
- Step 2: Add the dependency in your app module build.gradle file
bash dependencies { ... implementation 'com.github.Mindinventory:MIStoryView:0.0.1' }
Implementation
Step 1 : Provide a list of stories. (Note : Use MiUserStoryModel class only to provide list of stories)
class MainViewModel : ViewModel() { val mListOfUsers: ArrayList<MiUserStoryModel> = ArrayList() init { mListOfUsers.add(MiUserStoryModel("1", "Johny Curtis", ArrayList()).also { it.userStoryList.add( MiStoryModel( "https://i.picsum.photos/id/0/5616/3744.jpg?hmac=3GAAioiQziMGEtLbfrdbcoenXoWAW-zlyEAMkfEdBzQ", "Johny Depp", "10:08 PM" ) ) it.userStoryList.add( MiStoryModel( "https://i.picsum.photos/id/1/5616/3744.jpg?hmac=kKHwwU8s46oNettHKwJ24qOlIAsWN9d2TtsXDoCWWsQ", "Johny Depp", "07:50 AM" ) ) }) } fun updateListOfUser(mListOfUsers: ArrayList<MiUserStoryModel>) { this.mListOfUsers.clear() this.mListOfUsers.addAll(mListOfUsers) } }
Step 2 : Inflate recyclerview in your layout file.
<androidx.recyclerview.widget.RecyclerView android:id="@+id/rvStory" android:layout_width="match_parent" android:layout_height="wrap_content" android:clipToPadding="false" android:orientation="vertical" android:padding="@dimen/dp_8" app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager" app:layout_constraintEnd_toEndOf="parent" app:layout_constraintStart_toStartOf="parent" app:layout_constraintTop_toTopOf="parent" tools:listitem="@layout/item_user_story" />
Step 3 : Create a recyclerview row item, which consists MiStoryView class.
// See row item of sample app.
Step 4 : Create an adapter object and a resultAPI launcher to launch story detail view from your activity.
class MainActivity : AppCompatActivity() { // This is necessary snippet to listen the changes of seen stories data, // when user come back to the origin activity. private val launcher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { try { if (it.resultCode == Activity.RESULT_OK) { val list = arrayListOf<MiUserStoryModel>() it.data?.hasExtra(MiStoryDisplayActivity.MI_LIST_OF_STORY) ?.let { hasMiStoryList -> if (hasMiStoryList) { it.data?.getParcelableArrayListExtra<MiUserStoryModel>( MiStoryDisplayActivity.MI_LIST_OF_STORY )?.let { listOfUserStories -> list.addAll(listOfUserStories) } } } if (!mViewModel.mListOfUsers.containsAll(list)) { storyAdapter.setUserStoryData(list) mViewModel.updateListOfUser(list) } } } catch (e: Exception) { e.printStackTrace() } } // onCreateView here and invoke initView() method in it. private fun initView() { // Initialize your adapter here. // Provide launcher and list of stories from viewmodel for example // in constructor of that adapter. with(mBinding.rvStory) { ... storyAdapter = StoryAdapter(mViewModel.mListOfUsers, { launcher }, { this@MainActivity }) adapter = storyAdapter } } }
Step 5 : Create a recyclerview adapter. Must implement touch event of root view and dispatch that event to MiStoryView to launch Story detail view.
class StoryAdapter( private val launcher: ActivityResultLauncher<Intent>, private val launcherCallBack: () -> ActivityResultLauncher<Intent>, private val activityCallBack: () -> AppCompatActivity ) : RecyclerView.Adapter<RecyclerView.ViewHolder>() { override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder { // inflate your row item layout here } @SuppressLint("ClickableViewAccessibility") override fun onBindViewHolder(holder: RecyclerView.ViewHolder, position: Int) { if (holder is StoryViewHolder) { holder.mBinding.apply { // Dispatch touch event of root view // to MiStoryView to open full screen // story preview view. root.setOnTouchListener { view, motionEvent -> msvStory.dispatchTouchEvent(motionEvent) true } msvStory.apply { setActivity(activityCallBack.invoke()) setLauncher(launcherCallBack.invoke()) if (listOfUseStory.isNotEmpty()) { setImageUrls(listOfUseStory, holder.adapterPosition) } } tvUserName.text = mDataList[holder.adapterPosition].userName } } } // Other override methods here // Define viewholder class here fun setUserStoryData(mDataList: ArrayList<MiUserStoryModel>) { this.listOfUseStory.clear() this.listOfUseStory = mDataList notifyDataSetChanged() } }
XML Properties
Properties | Description |
---|---|
miPageTransformer | Set different animation while switching between stories |
miPendingIndicatorColor | Set color for unseen story |
miStoryImageRadius | Set size of round image |
miStoryItemIndicatorWidth | Set width of progress indicator |
miSpaceBetweenImageAndIndicator | Set margin between two progress bar indicator |
miVisitedIndicatorColor | Set color for seen story |
miFullScreenProgressBarHeight | Set height of progress in full story view |
miFullScreenGapBetweenProgressBar | Set margin between two progress bar indicator in full story view |
miFullScreenProgressBarPrimaryColor | Set primary color of progress bar in full story view |
miFullScreenProgressBarSecondaryColor | Set secondary color of progress bar in full story view |
miFullScreenSingleStoryDisplayTime | Set time for particular story (i.e in milliseconds) |
That's it :thumbsup: and you're good to go ๐
Guideline to report an issue/feature request
It would be very helpful for us, if the reporter can share the below things to understand the root cause of the issue.
- Library version.
- Code snippet.
- Logs if applicable.
- Screenshot/video with steps to reproduce the issue.
LICENSE!
MIStoryView is MIT-licensed.
Let us know!
If you use our open-source libraries in your project, please make sure to credit us and Give a star to www.mindinventory.com
Please feel free to use this component and Let us know if you are interested to building Apps or Designing Products.
*Note that all licence references and agreements mentioned in the MiStoryView README section above
are relevant to that project's source code only.