SambaLite - GitLite

KO | EN

gitlite — search

#javascript #python #hacktoberfest #typescript #android #machine-learning #rust #deep-learning #docker #nodejs #java #windows #ios #open-source

SambaLite

(★ 130)

SambaLite is a lightweight, modern, and open-source Android client for SMB/CIFS shares (Samba).

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - feature_request.yml
  - README.md
- - build.yml
  - code-quality.yml
  - ort-compliance.yml
  - release.yml
- CODEOWNERS
- FUNDING.yml
- pull_request_template.md
- build.gradle
- lint-baseline.xml
- proguard-rules.pro
- - sambalite-1200x630.png
- .nojekyll
- concept.md
- faq.html
- faq.md
- faq_de.html
- index.html
- index_de.html
- privacy_policy.html
- privacy_policy_de.html
- sync_user_guide.md
- transfer_queue_user_guide.md
- Appfile
- Fastfile
- Gemfile
- Pluginfile
- README.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- - config.yml
  - curations.yml
  - evaluator.rules.kts
- run-ort.sh
- run-scancode.sh
.gitignore
.ort.yml
AI_POLICY.md
build.gradle
CHANGELOG.md
CONTRIBUTING.md
Gemfile
Gemfile.lock
gradle.properties
gradlew
gradlew.bat
HEADER
LICENSE
README.md
settings.gradle

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/egdels/SambaLite

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd SambaLite

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

cd app

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

3. Ruby

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Ruby bundle 명령어를 쓰려면 Ruby가 필요합니다.

bundle install

Gemfile에 명시된 루비 라이브러리를 설치합니다.

✅ bundle install이 에러 없이 끝나면 README에 안내된 실행 명령어(예: rails server)로 마저 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# SambaLite

*Dedicated to my wife Eva, who inspired this project with her need to organize her files.*

SambaLite is a lightweight, modern, and open-source Android client for SMB/CIFS shares (Samba). It provides a minimalistic, reliable, and secure tool for accessing SMB shares on local networks without unnecessary features, ads, or bloat.

**Note:** SambaLite is an independent open-source project and is not affiliated with the official [Samba Project](https://www.samba.org/) or SerNet.  
The name refers solely to the supported SMB/CIFS network protocols.

[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png"
     alt="Get it on F-Droid"
     height="80">](https://f-droid.org/packages/de.schliweb.sambalite/)
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png"
     alt="Get it on Google Play"
     height="80">](https://play.google.com/store/apps/details?id=de.schliweb.sambalite)

[![Downloads last month](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgithub.com%2Fkitswas%2Ffdroid-metrics-dashboard%2Fraw%2Frefs%2Fheads%2Fmain%2Fprocessed%2Fmonthly%2Fde.schliweb.sambalite.json&query=%24.total_downloads&logo=fdroid&label=Downloads%20last%20month)](https://f-droid.org/packages/de.schliweb.sambalite/)
[![Downloads (all time)](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fgithub.com%2Fkitswas%2Ffdroid-metrics-dashboard%2Fraw%2Frefs%2Fheads%2Fmain%2Fprocessed%2Ftotal%2Fde.schliweb.sambalite.json&query=%24.total_downloads&logo=fdroid&label=Downloads%20(all%20time))](https://f-droid.org/packages/de.schliweb.sambalite/)

Or download the latest APK from the [Releases Section](https://github.com/egdels/SambaLite/releases/latest).

## APK Verification

All official releases of SambaLite are signed with one of the following certificates:

- **Upload key** (used for GitHub releases, F-Droid, and sideload APKs)  
  SHA-256: AE:32:2D:3F:B7:1A:FE:21:DF:47:27:E3:7A:5C:68:03:51:1D:5A:2F:E1:FC:31:35:43:0C:EE:06:99:FA:1B:34

- **Google Play App Signing key** (used for Play Store releases)  
  SHA-256: 51:97:00:8E:6A:6E:9E:03:31:FD:0D:B2:0E:A7:3F:DB:4C:5A:C1:AC:95:E8:C0:8E:0D:7C:F2:66:1D:46:BE:78

### Verify with apksigner
```bash
apksigner verify --print-certs SambaLite-vX.Y.Z.apk
```

## Features

| Feature                | Status | Description                                     |
| ---------------------- | ------ | ----------------------------------------------- |
| SMB/Share Connection   | ✅     | Connect with username/password and domain       |
| File Browsing          | ✅     | Navigate through folders and files              |
| Download/Upload        | ✅     | Transfer files between device and share         |
| Open Files             | ✅     | Open files directly from the share              |
| Share Files/Text       | ✅     | Share files and text to SMB shares              |
| Delete/Rename          | ✅     | Basic file operations with confirmation         |
| Search with Wildcards  | ✅     | Find files using * and ? wildcards              |
| Modern UI              | ✅     | Material Design with Dark Mode support          |
| Multiple Connections   | ✅     | Manage multiple shares with custom names        |
| Security/Privacy       | ✅     | Encrypted credential storage, no telemetry      |
| Folder Sync            | ✅     | Automatic background sync between device and share ([User Guide](docs/sync_user_guide.md)) |
| Transfer Queue         | ✅     | Background queuing for uploads and downloads ([User Guide](docs/transfer_queue_user_guide.md)) |

## Mobile Document Pipeline

SambaLite can be combined with
[MakeACopy](https://github.com/egdels/makeacopy) to create a fully
automated document workflow:

Paper document
        ↓
    Scan with MakeACopy
        ↓
    Inbox folder
        ↓
    SambaLite folder sync
        ↓
    NAS / archive (e.g. paperless-ngx)

This effectively turns your smartphone into a **privacy-friendly mobile network scanner**.

## Project Goals

- **Minimalism:** Only essential features, no unnecessary configurations
- **User-Friendly:** Clean, intuitive interface with minimal UI
- **Modern:** Using current Android libraries and best practices
- **Privacy-Focused:** No telemetry, tracking, or unnecessary permissions
- **Maintainable:** Clean, documented code that's easy to extend

## Technical Details

- **Language:** Java 11+
- **Architecture:** MVVM with Repository pattern
- **Dependencies:**
  - AndroidX and Material Design components
  - Dagger 2 for dependency injection
  - SMBJ for SMB client functionality
  - EncryptedSharedPreferences for secure credential storage

## Building the Project

1. Clone the repository
2. Open the project in Android Studio
3. Build and run the app on your device or emulator

## Security Notes

- Credentials are stored securely using Android's Keystore system
- No unencrypted storage of sensitive data
- Minimal permissions required (only network and user-selected storage access)
- Be cautious when using SMB in public or untrusted networks

**Privacy notice:** SambaLite processes all data locally on your device.  
No personal data is transmitted to the developer or any third parties.

## ❤️ Support this project
SambaLite is free and open source.
If you find it useful, please consider supporting development:

[![Ko-fi](https://img.shields.io/badge/Buy%20me%20a%20coffee-Ko--fi-orange)](https://ko-fi.com/egdels)
[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue)](https://www.paypal.com/paypalme/egdels)

## License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

## Third-Party Libraries

This project uses the SMBJ library (com.hierynomus:smbj), version 0.14.0, for SMB/CIFS client functionality.

SMBJ is licensed under the Apache License, Version 2.0.
For more information, see: https://github.com/hierynomus/smbj

Copyright (c) 2016-2024 Michael N. Heronimus

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

## Disclaimer / Limitation of Liability

This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

Where not permitted by applicable law (e.g. in cases of gross negligence or intent), this limitation of liability may not apply. Users utilize this software at their own risk.

## Privacy Policy

Our privacy policy is available on our [GitHub Pages site](https://egdels.github.io/SambaLite/privacy_policy.html).

## Related Projects

### MakeACopy

[MakeACopy](https://github.com/egdels/makeacopy) is a privacy-friendly
open-source document scanner for Android with offline OCR.

Together with SambaLite it enables a fully automated document workflow:

Paper
       ↓
    Scan with MakeACopy
       ↓
    Inbox folder
       ↓
    SambaLite sync
       ↓
    NAS / archive

This setup effectively turns your smartphone into a **mobile network
scanner** for self-hosted document archives such as **paperless-ngx**.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request