inaka/galgo

When you want your logs to be displayed on screen

Galgo

A tiny Android library for those moments when you want your logs to be displayed on screen.

Abstract

Sometimes we want/need to know what's going on behind the scenes but our app is not always connected to our computer to let us check the logs. Galgo will let you display your log messages as an overlay on top of your UI.

Extremely useful for testers who want to have more insight into what's going on behind the scenes in our apps when it misbehaves.

You can also define some basic settings such as background color, text color, text size and number of lines to display on screen so it better fits your needs.

How to download and Install

Add the following to your build.gradle file:

repositories {
	maven {
		url "https://jitpack.io"
	}
}

dependencies {
	// ...
    compile 'com.github.inaka:galgo:v1.0.2'
    // ...
}

Another option is to simply clone this repo and import it into Android Studio as a module.

Code Example

public class ExampleActivity extends Activity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_example);

        // add some customization to the log messages
        GalgoOptions options = new GalgoOptions.Builder()
                .numberOfLines(15)
                .backgroundColor(Color.parseColor("#D9d6d6d6"))
                .textColor(Color.BLACK)
                .textSize(15)
                .build();
        Galgo.enable(this, options);

        Galgo.log("I am a log message");
    }

    public void onDestroy() {
        super.onDestroy();

        // always call disable to avoid memory leaks
        Galgo.disable(this);
    }
}

Example

Here's an example of the log messages being displayed on top of our Activity:

Contact Us

If you find any bugs or have a problem while using this library, please open an issue in this repo (or a pull request :)).

galgo's Issues

The required permission could be integrated in the library's manifest

The SYSTEM_ALERT_WINDOW could be integrated in the library's AndroidManifest.xml, so that it would be automatically merged with the application's permission during build time.

system-overlay-window again on 6.0.1

And Android 6.0.1 api23 When I add this

compile 'com.github.inaka:galgo:v1.0.2'

The app crash with:

Caused by: java.lang.IllegalStateException: in order to use Galgo, please add the permission android.permission.SYSTEM_ALERT_WINDOW to your AndroidManifest.xml.

Even do I have this perrmission and also it´s included in galgo lib right

I cannot figure out this please advice?

I read that I should test for this permission since I side-lode the apk

https://stackoverflow.com/questions/32652533/android-system-overlay-window

but app crash before Activity onCreate

Gradle Upgrade

Android Studio recommends upgrading gradle

Put the galgo-release-1.0.aar download in the GitHUb releases section

Would be nicer and a little more standard to find the download link in the GitHub releases section.

new feature: disable Log.i()

hi, thank you for this great library, i just want to print the log on screen, can you add a method to disable Log.i() in public static void log(String message) method?

Push to maven central

Would be nice to have the .aar in maven central instead of downloading it :)

no log info print on the screen

Hey,
I use the demo code and try to print some log on my android phone, but nothing happen on the phone, and i check the Android Studio's Logcat, there've had the log which i want print on the phone.
Is there have some permission or setting need to do first?
thanks.

Gradle: build hanging

Am currently figuring out the issue but it seems that after it being fine for the last month or so, as of this morning if tinytask is included in my gradle dependencies then gradle build hangs indefinitely with no error report.

XiaoMi phone does not show up

Gradle: Build hanging

Am currently figuring out the issue but it seems that after it being fine for the last month or so, as of this morning if tinytask is included in my gradle dependencies then gradle build hangs indefinitely with no error report.

Fulfil the open-source checklist

General Items

• It has a github repo
• It has a proper LICENSE file
• It's has a clear and useful README.md
• It's documented (with examples)
• It's tested
• It's hooked to a the open-source hipchat room
• It has a link to the open-source hipchat room in its README
• It has a link to inaka.github.io in its README and/or landing page

Exhibition

• There is a blog post about it
• It's shared on social networks
• It's shared on reddit
• It's shared on hacker news with a title like Show HN: description
• It has a landing page built in github pages

For Libraries

• It provides a sample application
• Examples of use are documented in the README or linked from there

Nothing is displayed

Hi Dude... tried to use your library, but it doesn't work. I even went as far as declaring the permission for the service you have in the project but that didn't help. So essentially basic logs work but nothing gets displayed to the screen as you have stated it should.

Thanks