Okay, here’s the blog post in English first, followed by the Polish translation.
—
**English Version**
## Making Document Uploads Seriously Easy: Introducing the Paperless-NGX Uploader
Okay, let’s be honest. Managing a self-hosted Paperless-NGX instance can be… a *process*. Getting documents into it, especially on your Android device, can feel a little clunky. I’ve been wrestling with that myself, and I stumbled across something that’s genuinely simplified things. I wanted to share it with you.
It’s called the Paperless-NGX Uploader, and it’s a brand-new Android app built by a fellow self-hoster, @gmag11. It’s designed to make uploading your documents to your Paperless-NGX server ridiculously easy. Seriously, one-tap uploads? Yes, please.
**What’s it do?**
Essentially, the Paperless-NGX Uploader uses the native Share intent on Android. This means you can share *any* document – a PDF, an image, anything – from your favorite app, and select “Paperless-NGX Uploader” as the destination. It’s that simple.
**Here’s the breakdown:**
* **One-Tap Uploads:** No more fiddling with file managers or copying and pasting. Just select the file and hit send.
* **Secure Configuration:** The app lets you set up your server URL, credentials (or even an access token if you’re using OpenID), and even choose some default tags. Everything’s stored securely.
* **Smart Tagging:** It fetches your tags from the server and lets you quickly select or default ones for your uploads. There’s also smart filtering to help you find the right tags fast. It’s a *huge* time saver.
* **Real-Time Feedback:** You get immediate feedback – success returns you to the background, and failure shows you a clear message. No more wondering if it worked.
**Getting Started – It’s Easier Than You Think**
1. **Grab the App:** You can find the latest release (v1.5.3 as of August 8, 2025) on GitHub: [https://github.com/gmag11/Paperless_ngx_uploader](https://github.com/gmag11/Paperless_ngx_uploader)
2. **Configure:** Set up your server details, credentials, or token, and choose your default tags.
3. **Share:** Share a document from any app and select “Paperless-NGX Uploader.”
4. **Enjoy:** Effortless document uploads – smooth and secure.
**Why I’m Sharing This**
Honestly, this project is a fantastic example of the community stepping up. It’s built on the foundations of the older “Paperless Share” app, but it’s been completely modernized for Android. It’s a little thing, but it makes a *massive* difference in the overall experience. I really wanted to share it because I know a lot of us struggle with the technical bits of self-hosting.
**Give it a Star (Seriously!)**
If you find this useful, please head over to GitHub and give it a star! It helps the project and encourages the creator to keep it going. You can also fork the project if you want to contribute.
Let me know what you think – I’d love to hear your feedback, ideas, or if you encounter any issues. Happy self-hosting!
—
**Polish Version**
## Ułatwianie Przesyłania Dokumentów – Wprowadzenie do Przeglądarki Paperless-NGX
No dobrze, bądźmy szczerzy. Zarządzanie samohostowaną instancją Paperless-NGX może być… *procesem*. Otrzymywanie dokumentów do niej, szczególnie na urządzeniu Android, może wydawać się nieco niezręczne. Ja sam zmagałem z tym problemem, a natrafiłem na coś, co naprawdę to uprościło. Chciałem się tym z Wami podzielić.
Nazywa się Przeglądarka Paperless-NGX i została zbudowana przez innego samohostującego, @gmag11. Została zaprojektowana tak, aby przesyłanie Twoich dokumentów do serwera Paperless-NGX było niezwykle proste – jednym ruchem! Naprawdę? Zdecydowanie.
**Co to robi?**
W zasadzie, Przeglądarka Paperless-NGX wykorzystuje wbudowany mechanizm Share Intent na Androidzie. Oznacza to, że możesz udostępnić *dowody* – PDF, obraz, cokolwiek – z ulubionej aplikacji i wybrać “Przeglądarka Paperless-NGX” jako miejsce docelowe. Tak proste.
**Oto szczegóły:**
* **Przesyłanie Jednym Ruchem:** Bez zbędnego męczenia się z menadżerami plików lub kopiowania i wklejania. Po prostu wybierz plik i wyślij.
* **Bezpieczna Konfiguracja:** Aplikacja pozwala skonfigurować adres URL serwera, dane uwierzytelniające (lub token) i nawet wybrać domyślne tagi. Wszystko jest przechowywane bezpiecznie.
* **Inteligentne Tagowanie:** Pobiera tagi ze serwera i pozwala szybko wybrać lub ustawić domyślne tagi dla przesłanych dokumentów. Istnieje również inteligentne filtrowanie, które pomaga szybko znaleźć odpowiednie tagi. Jest to ogromny oszczędność czasu.
* **Informacje w czasie rzeczywistym:** Otrzymujesz natychmiastowe informacje zwrotne – sukces natychmiastowy powrót do tła, a niepowodzenie pokazuje czytelne komunikaty. Brak niepewności, czy coś się wydarzyło.
**Jak zacząć – jest to prostsze niż myślisz**
1. **Pobierz aplikację:** Możesz znaleźć najnowszą wersję (v1.5.3 w dniu 8 sierpnia 2025 r.) na GitHub: [https://github.com/gmag11/Paperless_ngx_uploader](https://github.com/gmag11/Paperless_ngx_uploader)
2. **Skonfiguruj:** Ustaw szczegóły serwera, dane uwierzytelniające lub token, a także domyślne tagi.
3. **Udostępnij:** Udostępnij plik z dowolnej aplikacji i wybierz “Przeglądarka Paperless-NGX”.
4. **Ciesz się:** Bezproblemowe przesyłanie dokumentów – płynnie i bezpiecznie.
**Dlaczego udostępniam to**
Szczerze mówiąc, ten projekt jest doskonałym przykładem, jak społeczność podnosi poprzeczkę. Został zbudowany na podstawie starszej aplikacji “Paperless Share”, ale została całkowicie zmodernizowana dla Androida. To mała rzecz, ale robi ogromną różnicę w całym doświadczeniu. Chciałem się tym podzielić, ponieważ wiem, że wielu z nas zmagamy się z technicznymi aspektami samohostowania.
**Daj Gwiazdkę (Serio!)**
Jeśli to jest przydatne, przejdź do GitHub i daj mu gwiazdkę! Pomaga to projektowi i zachęca twórcę do dalszego rozwoju. Możesz również skopiować projekt, jeśli chcesz wnieść swój wkład.
Dajcie znać, co o tym myślicie – z przyjemnością usłyszymy Wasze opinie, pomysły lub jeśli napotykacie jakieś problemy. Szczęśliwego samohostowania!