Bearsampp is dedicated to 64 bit architecture.
We recommend windows 11 but it may work on windows 10 also.
We use vs17, Thread safe, avx Achitecture(s). vs17 is built into our prerequisites package.
Contribute
Requirements
OpenJDK
You need OpenJDK ( minimum jdk 11 ) which can be obtained from here
if you use the .zip version of jdk then you will need to extract the archive on your computer (eg. C:\jdk
) and add the path to java.exe
(eg. C:\jdk\bin
) to your environment var PATH.
It's easier to use the .msi installer.
To check if you have Java in your path, open a command prompt and type java -version
:
openjdk version "11.0.2" 2019-01-15
OpenJDK Runtime Environment 18.9 (build 11.0.2+9)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.2+9, mixed mode)
When updating versions of Microsoft's JDK it does not remove the older version. You will need to use the Add/remove programs function of windows to remove the pre-existing version.
Apache Ant
Apache Ant is used with the OpenJDK to build and package the portapp.
You need at least Apache Ant 1.10.5 that you can download on the Apache website.
Extract the archive on your computer (eg. C:\apache-ant
) and add the path to ant.bat
(eg. C:\apache-ant\bin
) to your environment var PATH.
To check if you have Apache Ant in your path, open a command prompt and type ant -version
:
Apache Ant(TM) version 1.10.5 compiled on July 10 2018
Configuration
- Fork and clone the module of your choice.
- Clone dev in the parent folder of the module.
- Create a new pull request with your work.
For example :
cd C:\work\
git clone --recursive https://github.com/bearsampp/module-adminer.git
git clone --recursive https://github.com/bearsampp/dev.git
cd module-adminer\
Directory structure example :
[-] dev
| [-] build
| | | build-commons.xml
[-] bearsampp-{bin|app|tool}-{name}
| | build.xml
If you are not familiar with creating a pull request, you can create a new module like this :
- Increment the
build.release
in thebuild.properties
file using a YYYY.mm.dd format. Such as 2022.07.24 - If you want you can change the
build.path
(defaultC:\bearsampp-build
). - Open a command prompt in your module folder and call the Ant target
release
:ant release
. - Upload your release on a file hosting system like Sendspace.
- Create an issue on Bearsampp repository to integrate your release.
Requirements
- Windows 10 or later. ( Might run on Windows 7 but not supported )
- SETX : Open a command prompt and type
setx /?
to check. ( Included in windows 10+ as of this date ) - Be a windows Admin user.
- Download and install the latest Bearsampp Prerequisites Package. ( Required )
Download
Download the latest release
View all Bearsampp releases
*See our FAQ for a list of the differences in versions
Modules
Bearsampp offers several versions of the various binaries, applications and tools for download:
Installation
Use a file archiver that supports 7z format like 7zip and extract the archive where you want.
You should not have any white-spaces in the path to Bearsampp as that will cause problems on some modules.
Configuration
Before starting Bearsampp, edit the configuration file Bearsampp.conf
:
- lang - Language (see
Bearsampp\core\langs
folder for a complete list). Default :english
- timezone - The default timezone used by all date/time functions. Default :
"America/Chicago"
- notepad - The editor while opening files. Default :
"notepad.exe"
- logsVerbose - Control the log output verbose (0=simple, 1=report, 2=debug, 3=trace). Default :
0
- scriptsTimeout - The default timeout when VBS/Batch are executed. May vary depending on your system. Default :
120
The language, browser & log level can also be changed by right clicking on the icon and changing them there.
Usage
Launch Bearsampp.exe.
Upgrade
All instructions to upgrade from a previous release are added in the Upgrade notes page.
Request a module
Before submitting a request
Following prerequisites must be met:
- License allows distribution/repackaging of the software
- Abandonware will not be accepted
- Great visibility (based on Alexa rank and/or GitHub stars)
- Must be for windows 10 or higher.
Search for existing module requests. If you find your module request already exists, then make relevant comments and add your reaction
Use a reaction like - upvote or
- downvote in place of a “+1” comment.
If you cannot find an existing module request, submit a request using the guidelines below.
Writing a good module request
- Explain why the new module would be beneficial. Go into as much detail as you can.
- Use images and/or video if it helps make things clearer.
- DO NOT use any language other then English.
Then create a new module request and fill in the blanks!