An image loading library for Android backed by Kotlin Coroutines. Coil is:
- Fast: Coil performs a number of optimizations including memory and disk caching, downsampling the image in memory, re-using bitmaps, automatically pausing/cancelling requests, and more.
- Lightweight: Coil adds ~2000 methods to your APK (for apps that already use OkHttp and Coroutines), which is comparable to Picasso and significantly less than Glide and Fresco.
- Easy to use: Coil's API leverages Kotlin's language features for simplicity and minimal boilerplate.
- Modern: Coil is Kotlin-first and uses modern libraries including Coroutines, OkHttp, Okio, and AndroidX Lifecycles.
Coil is an acronym for: Coroutine Image Loader.
Made with
Download
Coil is available on mavenCentral().
implementation("io.coil-kt:coil:1.2.0")
Quick Start
To load an image into an ImageView, use the load extension function:
// URL
imageView.load("https://www.example.com/image.jpg")
// Resource
imageView.load(R.drawable.image)
// File
imageView.load(File("/path/to/image.jpg"))
// And more...
Requests can be configured with an optional trailing lambda:
imageView.load("https://www.example.com/image.jpg") {
crossfade(true)
placeholder(R.drawable.image)
transformations(CircleCropTransformation())
}
Image Loaders
imageView.load uses the singleton ImageLoader to enqueue an ImageRequest. The singleton ImageLoader can be accessed using an extension function:
val imageLoader = context.imageLoader
Optionally, you can create your own ImageLoader instance(s) and inject them with dependency injection:
val imageLoader = ImageLoader(context)
If you do not want the singleton ImageLoader, depend on io.coil-kt:coil-base.
Requests
To load an image into a custom target, enqueue an ImageRequest:
val request = ImageRequest.Builder(context)
.data("https://www.example.com/image.jpg")
.target { drawable ->
// Handle the result.
}
.build()
val disposable = imageLoader.enqueue(request)
To load an image imperatively, execute an ImageRequest:
val request = ImageRequest.Builder(context)
.data("https://www.example.com/image.jpg")
.build()
val drawable = imageLoader.execute(request).drawable
Check out Coil's full documentation here.
Requirements
- AndroidX
- Min SDK 14+
- Java 8+
R8 / Proguard
Coil is fully compatible with R8 out of the box and doesn't require adding any extra rules.
If you use Proguard, you may need to add rules for Coroutines, OkHttp and Okio.
License
Copyright 2021 Coil Contributors
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
https://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.
![[coil-video] Fails to load preview for video](https://avatars.githubusercontent.com/u/2393864?v=4)
39 Nov 4, 2022
98 Dec 15, 2022
8 Dec 1, 2022
4 Jul 29, 2020
41 Oct 17, 2022
77 Dec 8, 2022
27 Nov 14, 2022
133 Dec 14, 2022
411 Dec 22, 2022
171 Oct 31, 2022
4 Oct 31, 2022
50 Jan 7, 2023
508 Jan 3, 2023
28 Nov 1, 2022
2 Nov 12, 2021
10 Dec 11, 2022
104 Dec 24, 2022