Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
An image loading and caching library for Android focused on smooth scrolling
Java
Failed to load latest commit information.
.idea Add ide files for Intellij 14
glide-parent Add ide files for Intellij 14
glide Update imls.
gradle/wrapper Update Android gradle plugin to 1.x
integration Pass through headers into http fetchers.
library Avoid overriding status if cleared in Target.
samples Bump OkHttp and Volley versions.
scripts Add pre/postfix to integration source/javadoc jars
static Add logo.
testutil Update imls.
third_party Avoid unnecessary frame allocation in GifDecoder.
.gitignore Add ide files for Intellij 14
.gitmodules Simplify library build and remove unused files.
.travis.yml Allow travis containers.
CONTRIBUTING.md Add an issue template and CONTRIBUTING.md.
LICENSE Initial not compiling gif encoder
README.md Point to PNG image in readme.
build.gradle Update Android gradle plugin to 1.x
checkstyle.xml Allow underscores in method names.
checkstyle_suppressions.xml Add a clone() API to create copies of builders.
glide-parent.iml Update imls.
gradle.properties Bump to 3.6.0-SNAPSHOT.
gradlew Add jar target and get AndroidStudio 0.6.2 working.
gradlew.bat Add jar target and get AndroidStudio 0.6.2 working.
settings.gradle Pull out testutil project.

README.md

Glide

Build Status

Glide is a fast and efficient open source media management and image loading framework for Android that wraps media decoding, memory and disk caching, and resource pooling into a simple and easy to use interface.

Glide supports fetching, decoding, and displaying video stills, images, and animated GIFs. Glide includes a flexible api that allows developers to plug in to almost any network stack. By default Glide uses a custom HttpUrlConnection based stack, but also includes utility libraries plug in to Google's Volley project or Square's OkHttp library instead.

Glide's primary focus is on making scrolling any kind of a list of images as smooth and fast as possible, but Glide is also effective for almost any case where you need to fetch, resize, and display a remote image.

Download

You can download a jar from GitHub's releases page.

Or use Gradle:

repositories {
  mavenCentral()
}

dependencies {
    compile 'com.github.bumptech.glide:glide:3.5.2'
    compile 'com.android.support:support-v4:19.1.0'
}

Or Maven:

<dependency>
  <groupId>com.github.bumptech.glide</groupId>
  <artifactId>glide</artifactId>
  <version>3.5.2</version>
  <type>aar</type>
</dependency>
<dependency>
  <groupId>com.google.android</groupId>
  <artifactId>support-v4</artifactId>
  <version>r7</version>
</dependency>

How do I use Glide?

Checkout the GitHub wiki for pages on a variety of topics, and see the javadocs.

Simple use cases will look something like this:

// For a simple view:
@Override
public void onCreate(Bundle savedInstanceState) {
    ...

    ImageView imageView = (ImageView) findViewById(R.id.my_image_view);

    Glide.with(this).load("http://goo.gl/gEgYUd").into(imageView);
}

// For a list:
@Override
public View getView(int position, View recycled, ViewGroup container) {
    final ImageView myImageView;
    if (recycled == null) {
        myImageView = (ImageView) inflater.inflate(R.layout.my_image_view,
                container, false);
    } else {
        myImageView = (ImageView) recycled;
    }

    String url = myUrls.get(position);

    Glide.with(myFragment)
        .load(url)
        .centerCrop()
        .placeholder(R.drawable.loading_spinner)
        .crossFade()
        .into(myImageView);

    return myImageView;
}

OkHttp and Volley

Support for OkHttp and Volley is provided by integration libraries you can optionally include as dependencies. The integration libraries are available via Maven or the releases page.

For instructions on including either the OkHttp or the Volley integration libraries, see the Integration Libraries wiki page.

Android SDK Version

Glide requires a minimum sdk version of 10.

License

BSD, part MIT and Apache 2.0. See LICENSE file for details.

Status

Version 3 is a stable public release used in multiple open source projects at Google including in the Android Camera app and in the 2014 Google IO app. Comments/bugs/questions/pull requests welcome!

Build

Building Glide with gradle is fairly straight forward:

git clone git@github.com:bumptech/glide.git
cd glide
git submodule init && git submodule update
./gradlew jar

Note: Make sure your Android SDK has the Android Support Repository installed, and that your $ANDROID_HOME environment variable is pointing at the SDK or add a local.properties file in the root project with a sdk.dir=... line.

Samples

Follow the steps in the 'Build' section to setup the project and then:

./gradlew :samples:flickr:run
./gradlew :samples:giphy:run
./gradlew :samples:svg:run

Development

Follow the steps in the 'Build' section to setup the project and then edit the files however you wish. Intellij IDEA 14 cleanly imports both Glide's source and tests and is the recommended way to work with Glide.

To open the project in Intellij 14:

  1. Go to File.
  2. Click on 'Open...'
  3. Navigate to Glide's root directory.
  4. Select glide-parent.iml

Getting Help

To report a specific problem or feature request, open a new issue on Github. For questions, suggestions, or anything else, join or email Glide's discussion group, or join our irc channel: irc.freenode.net#glide-library.

Contributing

Before submitting pull requests, contributors must sign Google's individual contributor license agreement.

Thanks

Author

Sam Judd - @samajudd

Disclaimer

This is not an official Google product.

Something went wrong with that request. Please try again.