README.md
author Da Risk <da_risk@geekorum.com>
Tue, 24 Jun 2025 15:18:18 -0400
changeset 103 c78c87a77df2
parent 98 3dc5efd1855d
permissions -rw-r--r--
build: update to kotlin 2.2.20
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
90
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
     1
[![Release Version](https://img.shields.io/maven-central/v/com.geekorum.aboutoss/core?label=release)](https://search.maven.org/#search%7Cga%7C1%7Caboutoss)
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
     2
[![License](https://img.shields.io/github/license/fbarthelery/AboutOss)](https://github.com/fbarthelery/AboutOss/blob/main/LICENSE)
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
     3
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     4
AboutOss
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     5
==========
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
     6
98
3dc5efd1855d Update README.md
fbarthelery <da_risk@geekorum.com>
parents: 91
diff changeset
     7
### [fbarthelery.github.io/AboutOss](https://fbarthelery.github.io/AboutOss/)
3dc5efd1855d Update README.md
fbarthelery <da_risk@geekorum.com>
parents: 91
diff changeset
     8
3dc5efd1855d Update README.md
fbarthelery <da_risk@geekorum.com>
parents: 91
diff changeset
     9
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    10
AboutOss is a Kotlin Multiplatform utility library to retrieve and display opensource licenses in your applications.
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    11
90
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
    12
```kotlin title="build.gradle.kts"
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
    13
implementation("com.geekorum.aboutoss:ui-material3:<latest-version>")
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
    14
```
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
    15
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    16
License sources
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    17
---------------
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    18
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    19
The library can work with license information files generated by:
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    20
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    21
- [OSS Licenses Gradle Plugin](https://github.com/google/play-services-plugins/tree/main/oss-licenses-plugin)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    22
- [licensee](https://github.com/cashapp/licensee)
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    23
- [LicensePlist](https://github.com/mono0926/LicensePlist)
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    24
91
b3b57696b660 docs: separate docs/index and README
Da Risk <da_risk@geekorum.com>
parents: 90
diff changeset
    25
See [license sources](https://fbarthelery.github.io/AboutOss/license-sources/) for more information
90
260a6b232f4d docs: add badges and some intro to license-sources
Da Risk <da_risk@geekorum.com>
parents: 84
diff changeset
    26
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    27
User interface
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    28
--------------
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    29
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    30
The user interface to display license information is written in [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform).
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    31
There is out of the box composables for Material and Material3 and you can easily write your own UI.
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    32
84
f1e51fe391c2 docs: add documentation for different license sources and UI
Da Risk <da_risk@geekorum.com>
parents: 75
diff changeset
    33
Check the sample [here](https://github.com/fbarthelery/AboutOss/tree/main/sample) 
7
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    34
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    35
Build instructions
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    36
==================
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    37
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    38
Just use Gradle to build
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    39
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    40
    ./gradlew build
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    41
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    42
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    43
License
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    44
=======
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    45
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    46
AboutOss is an open source library and is licensed under the GNU General Public License 3 and any later version.
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    47
This means that you can get AboutOss's code and modify it to suit your needs, as long as you publish the changes
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    48
you make for everyone to benefit from as well.
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    49
b3b2e88f441f add README.md and maven publications
Da Risk <da_risk@geekorum.com>
parents:
diff changeset
    50
AboutOss is built and maintained by community volunteers.