关于项目

针对性攻击单词列表创建器：引入与目标相关的个人信息，组合每个单词并将结果转换为可能的密码。 lyricpass模块允许搜索与艺术家相关的歌词并将其包含到单词列表中。
可定制的大小写和leet 转换：通过简单的配置文件创建自定义字符集和转换模式。
支持交互模式和一行命令界面。
自 2019 年 8 月起包含在BlackArch Linux渗透测试发行版和Rawsec 的网络安全清单中。

内置

Python 3 （二级分支保留 Python 2.7 旧版支持）
- 要求
- 活着的进步

什么是新的

2.4.7 发布(02/09/2024)：速度和性能显着提高。新的扩展大小写转换模式允许生成所有可能的大小写转换。

（回到顶部）

入门

安装

 pip install bopscrk

或者，如果您想从 Github 克隆存储库而不是从 Pypi 安装它：

 git clone --recurse-submodules https://github.com/r3nt0n/bopscrk
cd bopscrk
pip install -r requirements.txt

运行交互模式

 bopscrk -i

（回到顶部）

用法


  -h, --help         show this help message and exit
  -i, --interactive  interactive mode, the script will ask you about target
  -w                 words to combine comma-separated (non-interactive mode)
  --min              min length for the words to generate (default: 4)
  --max              max length for the words to generate (default: 32)
  -c, --case         enable case transformations
  -l, --leet         enable leet transformations
  -n                 max amount of words to combine each time (default: 2)
  -a , --artists     artists to search song lyrics (comma-separated)
  -o , --output      output file to save the wordlist (default: tmp.txt)
  -C , --config      specify config file to use (default: ./bopscrk.cfg)
  --version          print version and exit

欲了解更多信息，请参阅高级使用部分。

（回到顶部）

它是如何运作的

您必须提供一些单词作为基础。
歌词通行证功能允许介绍艺术家。该工具将下载他所有歌曲的歌词，每行都将添加为一个新单词。默认情况下，还将添加艺术家姓名和每个短语上单词首字母组成的单词。
该工具将生成它们之间所有可能的组合。
为了生成更多组合，它会添加一些常见的分隔符（例如“-”、“_”、“.”）、数字和密码中常用的特殊字符。
您可以使用leet和case 转换来增加机会。

尖端

字段可以留空。
您可以在单词和特殊字符中使用重音符号（如果您使用非交互模式，请使用反斜杠转义特殊字符，例如'和" ，例如： bopscrk -w John,O'hara,Doe,foo,bar ）。
在其他字段中，您可以编写多个单词，以逗号分隔。示例：2C、Flipper。
如果要生成所有可能的 leet 转换，请在配置文件中启用recursive_leet 选项。
如果要生成所有可能的大小写转换，请在配置文件中启用extrassed_case选项。
您可以选择对通过cfg 文件找到的歌词短语应用哪些转换。
使用非交互模式，您应该以长短方式提供年份（1970,70）以获得与交互模式相同的结果。
你必须小心-n参数。如果设置很大的值，可能会导致单词列表太大。我建议使用 2 到 5 之间的值。
要通过命令行提供多个艺术家姓名，您应该提供以逗号分隔的名称。示例： -a johndoe,johnsmith
要通过命令行为艺术家名称提供空格，您应该将其用引号括起来。示例： -a "john doe,john smith"

（回到顶部）

高级用法

使用 .cfg 文件自定义行为

在bopscrk.cfg文件中，您可以指定自己的字符集并启用/禁用选项：
- extra_combinations （如(john, doe) => 123john, john123, 123doe, doe123, john123doe doe123john ）默认启用。您可以在配置文件中禁用它，以获得更有针对性的单词列表。
- seperators_chars ：在额外组合中使用的字符。可以是单个字符或字符串，例如： !?-/&(
- seperators_strings ：在额外组合中使用的字符串。可以是单个字符串或空格分隔的字符串列表，例如： 123 34!@
- leet_charset : leet 变换中要替换的字符和相应的替换，例如： e:3 b:8 t:7 a:4
- recursive_leet ：启用对 leet_transforms() 函数的递归调用以获取所有可能的 leet 变换。警告：使用巨大的--max值（例如：大于 18）启用可能需要很长时间。可以是真的也可以是假的。
- extra_case ：默认情况下，bopscrk 仅应用更常见的大小写转换：所有字符转换为小写，所有字符转换为大写，每个字符转换为大写，所有对转换为大写，所有赔率转换为大写，所有辅音转换为大写，所有元音转换为大写。您可以启用此选项来获取所有可能的大小写转换，这可能会导致更大的单词列表，但在某些情况下可能很有用。可以是真的也可以是假的。
- remove_parenthesis ：删除任何转换之前找到的歌词中的所有括号
- take_initials ：根据找到的歌词短语中每个单词的首字母生成单词（如果启用并禁用remove_parenthesis，则可能会生成无用的单词）
- Artist_split_by_word ：拆分艺术家姓名并将每个单词添加为新单词
- lyric_split_by_word ：与找到的歌词相同
- Artist_space_replacement ：用字符集中定义的字符/字符串替换艺术家姓名中的空格
- lyric_space_replacement ：与找到的歌词相同
- space_replacement_chars ：在艺术家姓名或歌词短语中插入代替空格的字符。可以是单个字符或字符串，例如： !?-/&(
- space_replacement_strings ：要插入的字符串，而不是艺术家姓名或歌词短语中的空格。可以是单个字符串或空格分隔的字符串列表，例如： 123 34!@
参数配置举例
- 使用点作为分隔符组合所有单词，并使用逗号作为分隔符
  separators_chars=.,
- 将所有出现的“a/A”转换为“4”，将所有出现的“e/E”转换为“3”
  leet_charset=a:4 e:3

（回到顶部）

抒情通行证

此功能基于最初由 initstring 开发的工具的修改版本。这些更改是为了将输入和输出工具与 bopscrk 集成。

它将检索属于您提供的艺术家的所有歌曲的所有歌词。默认情况下，它将存储每个艺术家、通过空格替换找到的每个短语、找到的每个短语缩减为其首字母（如果您激活了 leet 和 case 转换，则稍后将对其进行转换）。

（回到顶部）

路线图

改善内存管理
- 在执行期间将单词列表写入文件系统并将其用作缓存（#12）
提高绩效
- 改进并行逻辑
额外功能
- 实现进度条，让用户了解执行状态
- 实现会话文件来跟踪执行点并能够停止和恢复会话(#12)
- 为自定义大小写转换创建配置选项（例如：禁用对/奇数转换）
- 实现“pipable”输出以允许与其他工具集成（ -q标志将仅将最终单词列表输出到标准输出）

请参阅未决问题以获取建议功能（和已知问题）的完整列表。

（回到顶部）

贡献

贡献使开源社区成为学习、启发和创造的绝佳场所。我们非常感谢您所做的任何贡献。

如果您有更好的建议，请分叉该存储库并创建拉取请求。您也可以简单地使用标签“增强”打开问题。不要忘记给该项目一颗星！再次感谢！

分叉项目
创建您的功能分支（ git checkout -b feature/AmazingFeature ）
提交您的更改（ git commit -m 'Add some AmazingFeature' ）
推送到分支（ git push origin feature/AmazingFeature ）
打开拉取请求

贡献者

noraj 贡献了几个问题和拉取请求，可以修复一些重要的错误。他还自行管理了 BlackArch 和 RawSec 存储库中的工具添加，这提高了其受欢迎程度和使用量
nylocx 和 agoertz-fls 贡献了添加 Python3 支持
glozanoa 和 fabaff 贡献了添加 bopscrk 命令（setup.py 的改进）

谢谢大家！

（回到顶部）

变更清单

2.4.7 version notes (02/09/2024)
- 改进大小写转换逻辑（现在它尊重原始单词的大小写）
- 包括新的基本案例转换操作
- 实施扩展案例转换模式
- 修复拼写错误
2.4.6 version notes (30/08/2024)
- 提高并行性能（真正的多处理实现）
- 更好地处理配置解析器错误
- 修复拼写错误
2.4.5 version notes (02/08/2022)
- 进度条已实施并正在运行
- 包含version参数
- 文档得到改进
2.4.4 version notes (31/07/2022)
- 相对导入错误已修复
- 开始重构总体结构以允许包含进度条功能
2.4.3 version notes (28/07/2022)
- 修复项目结构以允许通过 pip 正确安装：
  - 添加 MANIFEST 以在构建 dist 时排除已编译和测试文件
  - 改进结构以正确地将所有结构复制到父目录内的 python 包目录中
  - 修复配置文件的相对路径
- 提供错误的配置文件时捕获异常（通知并退出）
2.4 version notes (26/07/2022)
- 启用pip install方法使安装过程更容易
- 开始实现更好的内存管理（缓存字表写入和读取 I/O 文件），但尚未工作
- 更新并修复与依赖项相关的小错误
- 删除的功能：“从其他单词列表中排除”，似乎没有用，还有其他工具可以完成这项特定工作
2.3.1 version notes
- 修复在 Windows 系统上运行时的命名空间错误（与 aux.py 模块相关，重命名为 auxiliars.py）
- 实现了单元测试（以及变换、排除器和组合器函数的简单单元测试）。
2.3 version notes (15/10/2020)
- 使用 cfg 文件对艺术家和歌词进行可定制的配置转换
- setup.py 的要求已更新
- 多线程逻辑改进
- Leet和案件顺序颠倒以提高运营效率
- 修复了歌词空间替换中的错误
- 删除重复项时修复了错误（类型错误：不可散列类型：'list' ）
- 内存管理和效率得到改善
- 分成模块以改进项目结构
- 修复了单词列表排除功能中的错误
2.2 version notes (11/10/2020
- 配置文件已实现
- 新功能：允许创建自定义字符集并通过配置文件转换模式
- 新功能：实现了递归 leet 变换（默认禁用，可以在 cfg 文件中启用）
2.2~beta version notes (10/10/2020)
- lyricpass集成已更新为可与 initstring 发布的最新版本一起运行
- --lyrics-all选项已删除（功能集成在其他选项中）
2.1 version notes (11/07/2020)
- 修复最小和最大长度错误
2.0/1.5 version notes (17/06/2020)
- 现在支持 PYTHON 3 ：主分支移至 Python 3。辅助分支保留 Python 2.7 旧版支持
0-1.2(beta) version notes
- EXCLUDE WORDLISTS ：使用多线程排除提高速度
- 新功能：与艺术家相关的歌词搜索增加了单词列表的机会