A synchronized dual-view UI component library for Android, inspired by the Soundcloud wave scroll view.

TimelineView provides a synchronized scrolling experience with two content views that move in complementary directions. Originally designed for audio waveform visualization, it's now a versatile component perfect for any timeline-based application.

Inspiration

This is the original Soundcloud wave scroll view that inspired this project.

Features

• Native Compose Implementation: Pure Compose implementation without XML dependencies
• Synchronized Scrolling: Perfect offset synchronization between past and future content
• Customizable Offset: Configure the scroll offset as a fraction of screen width
• Material 3 Support: Built-in Material 3 styling variants
• Flexible Content: Support for any drawable resources as timeline content

Quick Start

@Composable
fun MyScreen() {
    TimelineView(
        height = 120.dp,
        pastContent = R.drawable.my_past_content,
        futureContent = R.drawable.my_future_content
    )
}

Demo

Main Screen - Light Mode	Main Screen - Dark Mode
Use Cases - Light Mode	Use Cases - Dark Mode

Structure

• timelineview/: Core TimelineView library module
• app/: Demo application showcasing various use cases

Documentation

For detailed API documentation, see timelineview/README.md

License

Copyright 2025 Fernando Prieto Moyano

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.