Skip to content

Commit

Permalink
Version 1.0.0 Pull from dev
Browse files Browse the repository at this point in the history
Version 1.0.0
  • Loading branch information
DerEffi committed Jun 30, 2023
2 parents a6c94b9 + 4354e11 commit da9931b
Show file tree
Hide file tree
Showing 303 changed files with 42,706 additions and 1,439 deletions.
43 changes: 32 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,41 @@
# Pixelart
# <p align="center">DerEffi's Pixelart Display</p>

## Usage
Nobody reads the instructions...
Just plug it in :P
<img src="./images/overview.jpg" width="400" height="400" style="display: block;margin: auto;" />

## Installation
TBD
## About

## Notes
- image upload in 64x64 (browser downscaling not that great)
- image upload in rgb colorspace (browser color conversion not that great)
- no alpha channel (cant be displayed by led panel and is ignored)
This project is an ESP32 Display Matrix for displaying images, time and social stats on a 64x64 LED Matrix Panel (HUB75E). An overview about the functionalities can be found at the Project Site [pixelart.dereffi.de](http://pixelart.dereffi.de).

## Disclaimer

This project is not a product, but rather a diy project. I won't sell it. I probably won't do another one at all. There are some minor issues/inconviniences that I plan to address in the future, but I can not make any promises on if or when that could happen.

That being said, in general I'm happy with the current state (althought it's not perfect) and the core functionality works as expected. You can use my code to rebuild it yourself or use parts of the code for your own project. If there are any issues, I'm pleased to help. If you have any solutions I'm even more pleased if you contribute.

## Usage/Deployment

The project consist of three parts:
- the controller for the display: [/pixelart-controller](./pixelart-controller/)
- the webinterface for remote control of the display: [/pixelart-interface](./pixelart-interface/)
- the socials api for retrieving social data from different platforms: [/pixelart-api](./pixelart-api/)

The documentations for these projects can be found in the different subdirectories as well as additional files for api, schematics and my dev board pinout under `/docs`.
An already compiled version of the firmware and the webinterface for the device can be found on the project site for download if you plan to use it as is.
Please be aware, that I won't be giving out any api-keys for my hosted social-api service (more on that under [/pixelart-api](./pixelart-api/README.md)), so you will have to host this on your own.

## Credits

Among a few other libraries I use in this project, thanks especially to:
- [mrfaptastic's ESP32/HUB75 Library](https://github.com/mrfaptastic/ESP32-HUB75-MatrixPanel-DMA) used to output on the LED matrix at all
- [me-no-dev's Async Webserver library](https://github.com/me-no-dev/ESPAsyncWebServer) for making the webinterface possible
- [khoih-prog's Async HTTP Request Library](https://github.com/khoih-prog/AsyncHTTPSRequest_Generic) for retrieving social data on the controller
- [pgrimaud's instagram fetcher](https://github.com/pgrimaud/instagram-user-feed) for the retrieval of instagram data. Even if I don't use this library directly, I used it as a template for the authentication agains instagram apis

## Project Site
[pixelart.dereffi.de](pixelart.dereffi.de)

[pixelart.dereffi.de](http://pixelart.dereffi.de)

## Author

[DerEffi](https://dereffi.de)
[info@dereffi.de](mailto:info@dereffi.de)
1 change: 1 addition & 0 deletions docs/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Issues.md
Loading

0 comments on commit da9931b

Please sign in to comment.