https://github.com/kaoticz/nekollector

Desktop application that sources pictures of catgirls, written in Java with JavaFX.
https://github.com/kaoticz/nekollector

catgirls desktop-app java javafx

Last synced: 29 days ago
JSON representation

Desktop application that sources pictures of catgirls, written in Java with JavaFX.

• Host: GitHub
• URL: https://github.com/kaoticz/nekollector
• Owner: Kaoticz
• License: gpl-3.0
• Created: 2024-10-19T16:27:43.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-11-28T07:49:27.000Z (3 months ago)
• Last Synced: 2025-01-13T01:29:18.451Z (about 1 month ago)
• Topics: catgirls, desktop-app, java, javafx
• Language: Java
• Homepage:
• Size: 949 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Nekollector

Because who doesn’t love catgirls?

## What is Nekollector?

**Nekollector** is a sleek JavaFX application that brings you an endless supply of adorable catgirl images, sourced from some of the most popular APIs out there:

- [nekos.best]

- [nekos.moe]

- [Nekosia]

## Features

### 🐾 Catgirl Carousel

Scroll through images of catgirls one by one in a smooth, modern Java UI. (Yes, we said “smooth” and “Java” in the same sentence. Miracles happen.)

### 🟊  Favorites

Found the ultimate waifu? Hit that **Favorite** button, and she’ll be saved in the sidebar for easy access.

### 📥 Downloads

Like what you see? Download it with a click to cherish it forever (or set as your phone wallpaper, we don’t judge).

### 🎨 Responsive Design

Enjoy a responsive UI that doesn’t explode when you resize the window (unlike most Java apps).

## How to Get Started?

1. Head over to the [Releases] page.

2. Download the `zip` for the version most appropriate to your operating system.

3. Extract the `zip` file.

4. If you are on Windows, execute the file at `Nekollector/bin/Nekollector.bat`

5. If you are on Linux or macOS, execute the file at `Nekollector/bin/Nekollector`

## Compiling from Source

### Prerequisites

- [OpenJDK 23]

- [Maven]

- [Git] (Optional)

### Steps

1. Clone this repository: `git clone https://github.com/Kaoticz/Nekollector` **or** download the source code from the [Releases] page.

2. Navigate to the project's root directory: `cd Nekollector`

3. Compile it with Maven: `mvn clean javafx:jlink`

4. The compiled binaries should be located in `target/Nekollector`

## Demonstration

[Nekollector.webm](https://github.com/user-attachments/assets/c2d37f45-6343-4d95-aa0f-6826d5543581)

## License

Nekollector, a desktop application for visualizing and downloading catgirl images.

Copyright (C) 2024 Kotz

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

[Git]: https://git-scm.com/downloads

[nekos.best]: https://nekos.best/

[nekos.moe]: https://nekos.moe/

[Nekosia]: https://nekosia.cat/

[Maven]: https://bitbucket.org/mjensen/mvnvm/src/master/

[OpenJDK 23]: https://jdk.java.net/23

[Releases]: ../../releases/latest