💻 Desktop sync client for Nextcloud
Перейти к файлу
Nextcloud bot c75a324ef0
Fix(l10n): Update translations from Transifex
Signed-off-by: Nextcloud bot <bot@nextcloud.com>
2024-11-07 02:57:13 +00:00
.github Bump platisd/clang-tidy-pr-comments from 1.5.0 to 1.5.1 2024-11-03 10:22:43 +09:00
.tx
admin Update share link for AppImage tool. 2024-10-31 11:23:39 +01:00
cmake Update copyright year in macOS info.plist template 2024-11-05 16:18:16 +09:00
doc
man
nextcloud.client-desktop
shell_integration
src Start counting storage usage from 0 for macOS virtual files account 2024-11-05 14:59:53 +09:00
test
theme Fix Finder sidebar icon to work as a "template" image and change to SF Symbols lineweights 2024-10-17 15:54:45 +08:00
translations Fix(l10n): Update translations from Transifex 2024-11-07 02:57:13 +00:00
.clang-format
.drone.yml
.git-blame-ignore-revs
.gitattributes
.gitignore
.gitmodules
.swift-format.json
.tag
CHANGELOG.md
CMakeLists.txt Add xml-escaped version of application vendor variable in CMakeLists 2024-10-31 18:39:13 +08:00
CONTRIBUTING.md
COPYING
COPYING.documentation
CPackOptions.cmake.in
ChangeLog - Legacy
NEXTCLOUD.cmake
NextcloudCPack.cmake
README.md
VERSION.cmake
codecov.yml
config.h.in
craftmaster.ini
mirall.desktop.in
resources.qrc
sonar-project.properties
sync-exclude.lst
theme.qrc.in
version.h.in

README.md

Nextcloud Desktop Client

The Nextcloud Desktop Client is a tool to synchronize files from Nextcloud Server with your computer.

Desktop Client on Windows

🚀 Releases

For the latest stable recommended version, please refer to the download page https://nextcloud.com/install/#install-clients

Contributing to the desktop client

✌️ Please read the Code of Conduct. This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere and to explain how together we can strengthen and support each other.

👪 Join the team

There are many ways to contribute, of which development is only one! Find out how to get involved, including as a translator, designer, tester, helping others, and much more! 😍

Help testing

Download and install the client:
🔽 All releases
🔽 Daily master builds

Reporting issues

If you find any bugs or have any suggestion for improvement, please open an issue in this repository.

Bug fixing and development

1. 🚀 Set up your local development environment

1.1 System requirements

  • Windows 10, Windows 11, Mac OS > 10.14 or Linux

[!NOTE]
Find the system requirements and instructions on how to work on Windows with KDE Craft on our desktop client blueprints repository.

1.2 Optional

[!TIP] We highly recommend Nextcloud development environment on Docker Compose for testing/bug fixing/development.
▶️ https://juliushaertl.github.io/nextcloud-docker-dev/

1.3 Step by step instructions on how to build the client to contribute

  1. Clone the Github repository:
git clone https://github.com/nextcloud/desktop.git
  1. Create :
mkdir <build directory>
  1. Compile:
cd <build directory>
cmake -S <cloned desktop repo> -B build -DCMAKE_INSTALL_PREFIX=<dependencies> -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=. -DNEXTCLOUD_DEV=ON

[!TIP] The cmake variabel NEXTCLOUD_DEV allows you to run your own build of the client while developing in parallel with an installed version of the client.

  1. Build it:
  • Windows:
cmake --build .
  • Other platforms:
make

[!TIP] For building the client for mac OS we have a tool called mac-crafter. You will find instructions on how to use it at admin/osx/mac-crafter.

  1. 🐛 Pick a good first issue
  2. 👩‍🔧 Create a branch and make your changes. Remember to sign off your commits using git commit -sm "Your commit message"
  3. ⬆ Create a pull request and @mention the people from the issue to review
  4. 👍 Fix things that come up during a review
  5. 🎉 Wait for it to get merged!

Get in touch 💬

You can also get support for Nextcloud!

📜 License

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 2 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.